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
Go to Jira Settings > Work Items > Fields
Find your field and click its name.
Click the context name to open the context settings.
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 |
|---|---|---|
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.