Browse documentation
Docs/Custom Fields Toolkit/Select list options

Select list options

Let project admins maintain their own dropdown options, without Jira admin rights.

The problem. Adding one option to a select list is a Jira administrator task. That is why a request as small as “please add our new vendor to the dropdown” sits in a queue for a week.

What this does. Moves that one specific job to the people who own the process, and nothing else. The project admin cannot change the field, its contexts, its screens or its type.

Why a project-scoped context is required
Options are edited per field context. Delegation is only offered for select fields that have a context limited to a single project, so a project admin can never change options that another project depends on. If your field has one site-wide context, create a project-scoped one first.

Step 1 — a Jira admin enables the field

Jira → Apps → Custom Fields Toolkit → Select List Option ManagementIllustration

Select List Option Management

Delegate select list option management to Project Admins. Select a field to see its contexts and enable project-scoped ones.

Search fields...
Only fields with a delegable context
FieldTypeContextProjectDelegate
Affected ServiceSelect List (single)OPS contextOperations (OPS)
EnvironmentSelect List (single)Platform contextPlatform (PLAT)
VendorSelect List (multiple)Procurement contextProcurement (PROC)
Compliance checksCheckboxesRisk contextRisk (RISK)
Showing 1-4 of 4
  1. 1Make sure the field has a field context limited to one project. Create one in *Settings → Issues → Custom fields → field → Contexts* if needed.
  2. 2Open Jira → Apps → Custom Fields Toolkit → Select List Option Management.
  3. 3Find the field and context in the table and switch Delegate on.

Four field types can be delegated, not only the two the name suggests: Select List (single), Select List (multiple), Checkboxes and Radio Buttons. They all hold a list of options and they are all edited the same way.

The table is searchable and paginated, and Only fields with a delegable context filters it down by probing each field's contexts — it reports progress as it goes, because on a site with thousands of custom fields that check takes a moment. Each row links straight out to the field's and the context's own Jira configuration screens.

Important
If the table is empty, no field on your site has a project-scoped context yet. That is the prerequisite, not a bug. And if your site has more custom fields than can be read in one request, the screen says so above the list and asks you to narrow it with the search box — it does not present a partial list as the whole.

Step 2 — the project admin manages the options

Project settings → Select List OptionsIllustration

Select List Options

Add Option

Manage options for select list fields in this project.

Field
Affected Service
Option ValueStatusOrderActions
Checkout APIEnabled
Move upMove down
EditDelete
PaymentsEnabled
Move upMove down
EditDelete
Legacy billingDisabled
Move upMove down
EditDelete
Showing 1-3 of 3
  • The page is at Project settings → Select List Options, and lists only the fields delegated for that project. If none are, it says a Jira administrator has to enable one first.
  • Add Option adds a value. Click a value to rename it. Delete removes it after a confirmation that says the action cannot be undone.
  • An option can be switched from Enabled to Disabled instead of deleted. Disabling keeps it on the issues that already use it, while removing it from the dropdown for new work.
  • Move up and Move down reorder the list, which is the order users see in the dropdown. Long lists are paginated.
Teach your project admins to disable, not delete
Deleting an option that is in use makes historical issues harder to read and reports harder to trust. Disabling achieves the same thing for new work with none of the damage.
ActionWho can do it
Enable a field for delegationJira administrator
Add, rename, reorder, disable or delete an option of a delegated fieldAnyone with Administer projects on that project
Anything else about the field — its contexts, screens, type or nameJira administrator only

Something missing or wrong on this page? Tell us in the support portal or email contact@synapseoasis.com.