Field Configuration

Field Configuration

Each field instance can be independently configured to control which Spaces appear in the picker. Choose one of three filter modes to match your use case.

Opening field configuration

  1. Go to Jira Settings > Work Items > Fields

  2. Find your field and click its name.

  3. Click the context name to open the context settings.

  4. Click Configure to open the field configuration panel.

Filter modes

Select one mode using the radio buttons at the top of the configuration panel:

Mode

What it does

Best for

Mode

What it does

Best for

Space types

Restricts the picker to Software, Service Management, and/or Business Space types.

Fields that should only show one category of Space (e.g. only JSM Spaces).

Space categories

Restricts the picker to one or more Space categories defined in Jira.

Fields scoped to an org unit or team grouping managed via Space categories.

Specific Spaces

Shows only the Spaces you explicitly select in the configuration panel.

Fields with a fixed, known set of Spaces (e.g. "Affected Products" with a fixed list of product Spaces).

Space types mode

Check one or more Space types to restrict the picker:

  • Software: Scrum and Kanban software Spaces

  • Service Management: JSM service desk Spaces

  • Business: Business and team-managed Spaces

Leave all unchecked to allow all Space types.

Space categories mode

Select one or more categories from the list. Categories are defined in Jira Settings > Spaces > Space categories. Leave the list empty to allow all categories.

Specific Spaces mode

Select individual Spaces from the list. The admin sees all Spaces on the instance (up to 200 live and archived). Users will only see the selected Spaces that they also have Browse Spaces permission for.

Quick-add by type and category

Above the Space selector, buttons group all available Spaces by Space type and by Space category. Each button shows how many Spaces in that group are already added (e.g. software (4/12)):

  • Click a button to add all Spaces in the group.

  • Click it again (when fully added) to remove the whole group.

This is the fastest way to add a large set of related Spaces without selecting them one by one.

Preview panel

After selecting Spaces, click Show preview to see a mockup of the picker as users will experience it. The preview shows:

  • A search box pre-populated with all allowed Spaces

  • The first 10 Space names listed below (with a count of any additional Spaces)

Click Hide preview to collapse it.

Archived Spaces in specific Spaces mode

Archived Spaces are shown in the admin list with an (Archived) label so admins can identify and remove them from the allowlist. Archived Spaces are automatically excluded from the picker when users edit issues: they cannot be newly selected, but any keys previously saved to issues are preserved and labelled (Archived) when viewed.

Specific Spaces mode is the most precise option. Use it when the valid values are a fixed, known set of Spaces such as "Affected Product" with 5-10 product-team Spaces.

Saving configuration

Click Save in the configuration panel. The new filter takes effect the next time a user opens the field picker on an issue.