Create a field context and define where it’s used

Once you’ve created a field, you can create a context to use in specific places in your site.

Create or edit a context

The process for editing an existing context is the same as creating a new one. To start, you’ll need to navigate to the Configure custom field page:

  1. Navigate to the Jira admin panel using the Settings () icon in the top navigation and select Work items.

  2. In the Fields section in the side navigation, select Fields.

  3. On the field you want to make a context for, select More actions () then Contexts and default value. This will open in a new tab in your browser.

  4. Add a new context or select one to edit.

    1. If you want to create a new context, select Add new context.

    2. To modify an existing context, select Edit context next to the one you want to change.

  5. In the box labeled Field context name, give your context a name, and a description. These only show on the previous context page, and won’t be visible to users in your site.

  6. Choose where you want this context to apply based on:

    1. Work type — Select the work types you want this context to appear on from the list under Choose applicable work types. Hold command (Mac) or Ctrl (Windows) to select multiple work types at once. Select Any work type to apply it to all work types, including those in team-managed spaces.

    2. Spaces — Select the spaces you want this context to apply to from the list under Choose applicable spaces. Hold command (Mac) or Ctrl (Windows) to select multiple spaces at once. Select All spaces to apply this context to all spaces.

  7. When you’re satisfied, select Add or Modify to save your changes.

You can then configure settings such as default values, options, and user filtering for the context.

When choosing spaces and work types:

  • Two contexts that include the same specific space cannot both select the same specific work type. For example, one can apply to bugs and another to tasks.

  • You can also have one context for Any work type in that space.

  • For contexts with All spaces selected, each specific work type can be selected in only one context.

There must be exactly one "global" context for each field, which covers all spaces and any work type. To use different settings for particular spaces or work types, create another context.

How Jira chooses a context

Jira uses a work item's space and work type to choose one context for each field. It checks for a matching context in this order and uses the first match:

  1. A context for the specific space and work type.

  2. A context for the specific space and any work type.

  3. A context for all spaces and the specific work type.

  4. The global context, which covers all spaces and any work type.

To check which context is applied to a given space and work type, use the filters on the Configure custom field page for the field. With space and work type both set, this will show the exact context that applies.

Still need help?

The Atlassian Community is here for you.