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.

The list of Issue Pickers, shown in two parts: Name, Multi select, Link type and Current space, then Subtasks, Filter, Contexts and Actions.
ColumnWhat it shows
NameThe name of the Issue Picker field.
Multi selectWhether several work items can be picked.
Link typeThe Jira link created for each pick, with its direction (inward or outward).
Current spaceWhether the defaults offer only work items of the current space.
SubtasksWhether subtasks of the current work item are offered.
FilterThe default JQL of the picker. Context filters are shown in the contexts list.
ContextsHow many contexts the picker has.
ActionsUpload (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.
The toolbar above the list: Card view, Hide filters, Re-index and + Issue Picker, with the filters below.

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.

⚠ Restoring from the trash

If you restore the field from Jira's trash, its settings do not come back. After a Re-index, the picker appears again with default settings and without contexts.

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

  1. Click + Context.
  2. 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”.
  3. 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.
  4. In the section Display, choose the display fields for this context.
  5. Check the result in the preview and click Create.
Create context: the section Contexts with a space and the list of its work types, including All work types.
The Selection section of a context with the search switches, the selection filter modes JQL and Dynamic JQL and the JQL editor.
The Display section of a context with the display fields and a preview row.

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.

â„č Restrictions during the re-index

While it runs, creating, editing and deleting Issue Pickers and contexts is disabled, and so are the switches in the lists. The list reloads by itself when the re-index is done.

Jump to: