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.

4. 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.

---

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

JQL Validation on Edit

The Issue Picker field includes an intelligent validation to maintain data integrity when the JQL filter is changed.

• What happens if I change the JQL and there are issues that no longer meet the new condition?
  • The issues that were already selected in the field will be kept, but when editing the issue, the user will see a warning above the field indicating which issues are no longer valid.

This prevents the loss of historical data and, at the same time, ensures that new selections adhere to the rules you have defined.

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.

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.

---

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:

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

JQL Search

All Issue Picker fields are indexed by Jira, and their content can be searched via JQL. This allows you to create advanced queries, filters, and dashboards based on the values of your Issue Picker fields.

How it works

When you select an issue in an Issue Picker field, the field stores the key of that issue (e.g., PROJ-123). Therefore, your JQL searches should use the issue keys to filter.

Supported Operators

You can use the standard JQL operators for text fields, such as:

Operator	Search Example
=	"My Issue Picker Field" = "PROJ-123"
!=	"My Issue Picker Field" != "PROJ-123"
IN	"My Issue Picker Field" IN ("PROJ-123", "PROJ-456")
NOT IN	"My Issue Picker Field" NOT IN ("PROJ-123", "PROJ-456")
IS	"My Issue Picker Field" IS EMPTY
IS NOT	"My Issue Picker Field" IS NOT EMPTY

Remember to replace "My Issue Picker Field" with the actual name of your custom field.

---