Getting Started

Discover VIP.LEAN Issue Picker for Jira Cloud: picker fields filled by JQL or Dynamic JQL, a filter per space and work type, Jira links in sync both ways, and no option limit.

1. Why Issue Picker

VIP.LEAN Issue Picker turns Jira custom fields into picker fields for work items. A JQL filter decides which work items each picker offers, and every pick can become a native Jira link.

Compared with plain Jira links, this gives you:

  • Only the right work items: filter by space, work type, status or any other field.
  • A filter that knows the current work item: with Dynamic JQL, a picker offers for example only work items of the same customer.
  • One field, many contexts: a different filter, search and display per space and work type.
  • Links in sync: picks create Jira links, and links created or deleted in Jira can update the field.
  • Your choice of display: single or multi-select, and which details the work item view shows: work type, key, summary, status, assignee, priority.
  • Automation: Jira Automation can read and set Issue Picker fields.
The field Risks on a project offers open risks only, because its selection filter is issuetype = Risk AND statusCategory != Done.

2. Key Concepts

ConceptWhat it means
Issue PickerA Jira custom field of the type VIP.LEAN Issue Picker. You create and manage it under Settings â€ș Apps â€ș Issue Picker.
Selection filterThe query that decides which work items the picker offers, written as JQL or Dynamic JQL.
Dynamic JQLA selection filter that uses values of the current work item, written as currentItem.<field>, e.g. Customer = currentItem.Customer.
ContextA set of spaces and work types with its own selection, search and display settings. Everywhere else, the picker's defaults apply.
Display fieldsWhat the work item view shows for each picked work item.
Link typeThe Jira link created for each pick, plus two switches for the way back from Jira links to the field.
Auto-fillFills empty pickers from links that already exist, e.g. after a migration.

3. What's New

The current release of Issue Picker brings:

  • Dynamic JQL: a context filter can use values of the current work item (currentItem.<field>), with the fallbacks .falseIfEmpty and .trueIfEmpty and a preview per screen. See How to Filter by the Current Work Item with Dynamic JQL.
  • Display fields: work type, summary, assignee and priority can be shown for each picked work item.
  • Subtasks: add subtasks of the current work item to what a picker offers.
  • Redesigned administration: an editor with the sections Field, Selection, Display and Links, a live preview of the search, table and card view, and more filters.
  • Jira's new work item view is supported; an empty field shows “None”.
  • Contexts are built from spaces and work types, and the wording follows Jira: space, work item, work type.
Dynamic JQL in a context. The preview shows the search sent to Jira for a chosen work item and screen.

4. Why VIP.LEAN Issue Picker

We first built Issue Pickers as part of VIP.LEAN Advanced Links, an app on Atlassian's Connect framework. VIP.LEAN Issue Picker combines that experience with the Atlassian Forge platform: it is hosted by Atlassian, and we removed limits wherever we could.

FunctionVIP.LEAN Advanced LinksVIP.LEAN Issue Picker
App hostingHosted by VIP.LEAN Solutions GmbH – GermanyHosted by Atlassian
MultitenancyVIP.LEAN Solutions GmbHAtlassian
Logging platformVIP.LEAN Solutions GmbHAtlassian
Data residency–Provided by Atlassian
Limit of the option list10,000 per context fieldNo limit (tested with 200,000)
Full support of space typesPartialYes
Different JQL for different contextsYesYes
Restriction to current spaceNoYes
Parallel managementNoYes
REST API error handlingBasicFull (Atlassian)
Paging of long option listsNoYes
Jira Service ManagementYesYes
Indexing of optionsRequiredNot needed (live Jira search)
Summary changesWith delayShown immediately
Hide work item keys–Yes
Link sync after picker changesYesYes
Picker sync after link changesYesYes
Automation rulesYes (complex)Yes (simple)

5. Examples

  • Risks on a project: a Risks field offers only open risks, and each pick links the risk to the project with “has risk”.
  • Same customer: with Dynamic JQL, a request offers only contracts or assets of its own customer.
  • Feature-story mapping: a field on stories lists all features of the same space.
  • Cross-referencing bugs: a field on bugs lists the stories or tasks where the bug was found.
  • Departments and locations: keep departments or sites as work items and let people pick them, so work is categorized consistently.
  • Dependency management: a field lists possible dependencies, so teams see what their work relies on.
  • Customer feedback: link feedback to the features or products it is about, for better product planning.

These are just a few examples – contexts and Dynamic JQL let you shape Issue Pickers for many more use cases.

Jump to: