Skip to main content
Version: Next

Field Configuration

Quick access: You can also get to this same configuration page from the Fields Dashboard, which centralizes all your Issue Picker fields.

The Issue Picker Cloud field configuration is integrated directly into the Jira Cloud administration, allowing you to manage its behavior from the same place you manage the rest of your custom fields.

Where to find the configuration?​

To start configuring your field, follow these steps:

  1. From the main Jira navigation, go to Settings (⚙️) and then to Issues.
  2. In the left sidebar, under the FIELDS section, click Custom fields.
  3. Find your Issue Picker Field type field in the list. On the right, click the actions menu (•••) and select Contexts and default value.

Access to field configuration

  1. Within the field's context settings, you will find the link to Edit custom field configuration. Clicking it will open the add-on's specific configuration modal.

Configuration modal

The configuration modal allows you to customize both the logic and the appearance of the field through two tabs: General and View.

General Tab​

Here you define the business rules for your field.

Limit selectable issues with JQL​

Use the JQL Filter field to create a query that filters the issues users can find and select. This is ideal for ensuring that only relevant issues are linked.

  • Use case: If you want a field to only allow linking "Bugs" from the current project that have not been closed, you could use a JQL like: 
    project = currentProject() AND issuetype = Bug AND status != Closed

Enable multiple selection​

By default, the field only allows selecting one issue. If you need to link multiple issues, change the Selection type to Multiple selection.

General configuration tab

Add a help note​

The Note field allows you to write a short text as a visual aid for users who access the field configuration.

General configuration tab

View Tab​

Here you customize the information displayed for the selected issues, giving your team context at a glance without needing to open the issue in a new tab.

Enrich the field display​

In addition to the icon, key, and summary of the issue (which are always displayed), you can choose to show:

  • Assignee: Shows the avatar of the issue's assignee.
  • Status: Shows the current status of the issue with its corresponding color (e.g., "In Progress," "Done").
  • Priority: Shows the issue's priority icon.

By activating these options, the information will appear directly in the issue view where the field is used, as seen in the following image:

Enriched information view

Once you finish adjusting the settings, don't forget to click Save Changes.

View configuration tab