How to Manage Existing Issue Pickers
Learn how to manage your VIP.LEAN Issue Pickers: the list and its filters, quick switches, editing and deleting, contexts per space and work type, and Re-index.
1. The List of Issue Pickers
Required Jira Role: Jira Administrator
Open Settings âș Apps and choose Issue Picker in the sidebar. The page lists all Issue Pickers of your Jira site.

| Column | What it shows |
|---|---|
| Name | The name of the Issue Picker field. |
| Multi select | Whether several work items can be picked. |
| Link type | The Jira link created for each pick, with its direction (inward or outward). |
| Current space | Whether the defaults offer only work items of the current space. |
| Subtasks | Whether subtasks of the current work item are offered. |
| Filter | The default JQL of the picker. Context filters are shown in the contexts list. |
| Contexts | How many contexts the picker has. |
| Actions | Upload (Auto-fill), Edit, Delete and Contexts. |
Above the list you find:
- Card view / Table view to switch the layout. On narrow screens the list always shows cards.
- Show filters / Hide filters. Filter by Link type, Multi select, Subtasks, Space in context, Work type in context and Field in dynamic conditions (the fields that a Dynamic JQL reads), or search by name.
- Re-index (chapter 5) and + Issue Picker.

1.1 Switches in the List
You can turn Multi select, Current space and Subtasks on or off directly in the list. A dialog tells you what the change means, e.g. âOnly work items of the current space are offered.â, and saves it when you confirm.
2. Edit an Issue Picker
Required Jira Role: Jira Administrator
Click Edit in the row. The editor opens with the sections Field, Selection, Display and Links; save with Apply. Name and description are saved on the Jira custom field. All settings are described in How to Create and Configure Issue Pickers.
3. Delete an Issue Picker
Required Jira Role: Jira Administrator
Click Delete in the row and type delete to confirm. The Jira custom field is moved to Jira's trash, and the app removes the settings and all contexts of the picker. Jira links that the picker created are kept.
4. Contexts
Required Jira Role: Jira Administrator
A context gives an Issue Picker its own Selection (search switches and filter) and Display for specific spaces and work types. Everywhere else, the picker's defaults apply. Name, Multi-Select and Links are the same in every context.
- A context holds one or more spaces, each with chosen work types or All work types, which also covers work types added later.
- A work type of a space belongs to one context of the picker only, so contexts never overlap.
- A new context starts with the picker's current values. Once saved, it keeps its own values; later changes to the picker's defaults do not change it.
4.1 Open the Contexts of a Picker
Click Contexts in the row. The list shows each context with its spaces and work types, Current space, Subtasks, Filter and Dynamic conditions (the fields its Dynamic JQL reads). You can filter it and turn the switches on or off directly, as in the main list.
4.2 Create a Context
- Click + Context.
- In the section Contexts, click Add new context to add a row, choose a space and its work types. Add more rows for more spaces. Spaces whose work types all belong to other contexts are shown as âIn another contextâ.
- In the section Selection, set the search switches and the Selection filter: JQL, with Restricted to current space and Add subtasks of the current work item, or Dynamic JQL. In JQL mode, the context needs a JQL filter or Restricted to current space.
- In the section Display, choose the display fields for this context.
- Check the result in the preview and click Create.



Dynamic JQL lets a context filter by values of the current work item. See How to Filter by the Current Work Item with Dynamic JQL.
4.3 Edit or Delete a Context
Use the Edit and Delete icons of the context. Deleting asks you to type delete; afterwards the picker's defaults apply to those spaces and work types again.
5. Re-index
Required Jira Role: Jira Administrator
Click Re-index when:
- you created an Issue Picker field in Jira's custom field settings instead of in the app,
- an Issue Picker field was deleted or restored outside the app, or
- the app was uninstalled and installed again.
Re-index rebuilds the list of Issue Pickers from the Issue Picker fields in Jira. Known pickers keep their settings and take over the field name from Jira. New fields get default settings. Pickers whose field no longer exists in Jira are removed. Settings from older app versions are updated to the current format.
Re-index does not index work items: the field always searches Jira live.