Configuring a custom field

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

When you create a custom field as a Jira administrator, you automatically create what's called a custom field context or custom field configuration scheme. This lets you select a custom field language and default value, as well as which issues types or projects the custom field appears in. If you're looking to simply edit the name or description of a custom field, or if you need to delete a custom field, check out Adding, editing, and deleting a custom field

 On this page, we'll cover the following tasks to help you configure a custom field: 

How to create a custom field context

You can create a new custom field context if you need to associate different default values and options with different projects or issue types. Note that you can only specify one custom field context for each project.

Creating a new context for a custom field where values have already been set on issues can cause data loss. See this knowledge base article for a guide on doing this safely.

See also:

JRACLOUD-62455 - Getting issue details... STATUS


To create a new context: 

  1. Select the Jira icon (, or ) > Settings > Issues.

  2. In the Fields section, click Custom Fields.
  3. Find the custom field you want to configure and click  > Configure > Add new context.
  4. Enter a label and description for your new context. These are used for your reference in the administration section only and will not be shown to your end users.
  5. In the applicable issue types section, select the issue types that you want this custom field field to appear in. 
  6. In the applicable contexts section, select a global context or choose specific projects that you want this custom field to appear in. Note that the custom field will only appear on issues types you previously selected.  
  7. Select Create.

How to edit a custom field context

  1. Select the Jira icon (, or ) > Settings > Issues.

  2. In the Fields section, click Custom Fields.
  3. Find the custom field you want to configure and click  > Configure.
  4. Locate the context you want to change and click Edit Configuration.
  5. In the applicable issue types section, select or unselect the relevant issue types.
  6. In the applicable contexts section, select or unselect the relevant projects.
  7. Select Modify

How to set the default value for a custom field

You can choose to automatically fill each custom field with a default value. Note that certain types of custom fields may not allow for default values. For fields that do, you can set a default value with these steps: 

  1. Select the Jira icon (, or ) > Settings > Issues.

  2. In the Fields section, click Custom Fields.
  3. Find the custom field you want to configure and click include > Configure.
  4. In the configuration scheme section, select Edit Default Value
  5. Enter a default value (e.g. for a custom Story Points field, set the value to 4) and click Set Default.
tip/resting Created with Sketch.

Tip:

For a select list or multi-select list custom field, you can clear the default value by clicking on the current default so it's no longer highlighted.

How to manage associated screens

You can control which screens the custom field will appear on when an issue is created, edited or transitioned through workflow. Follow these steps to change which screens your custom field is associated with: 

  1. Select the Jira icon (, or ) > Settings > Issues.

  2. In the Fields section, click Custom Fields.
  3. Find the custom field and click  > Screens.
  4. Check the screens on which you want to display this custom field.


The new issue view uses the View issue screen scheme to determine which fields to show. To add or remove a custom field, head to your project, Choose Settings > Screens, then select the View issue screen scheme and remove the field.

How to translate a custom field

You can translate the name and description of any custom field that you create using Jira's pre-installed language packs. To translate a field:

  1. Select the Jira icon (, or ) > Settings > Issues.

  2. In the Fields section, click Custom Fields.
  3. Find the custom field you want to translate and click  > Translate
  4. Choose the language pack that this custom field translation will belong to (e.g. French), and enter the translated strings for the field name and description.
  5. Click Update when you're done. 

How to specify values for fields with options

You can specify option values for the following custom fields types:

  • Select lists
  • Multi select lists
  • Cascading select lists
  • Radio buttons
  • Multi checkboxes

To edit option values for the above custom field types, follow these steps: 

  1. Select the Jira icon (, or ) > Settings > Issues.

  2. In the Fields section, click Custom Fields.
  3. Find the custom field you want to configure and click  > Configure Edit Options. Here you can:
    • Select the Edit parent select list drop-down to choose which cascading select list to edit. 
    • Click Sort alphabetically to automatically reorder the options alphabetically.
    • Click the arrows in the Order column, or specify a number and click the Move button, to reorder the options manually.
    • Click Edit to change the text of an option.
    • Click Disable to hide an option so that it is no longer available for selection. You cannot remove options that have already been used (to preserve data), but you can make them unavailable for new issues.
    • Click Delete to remove an option that has not been used.

Note that these options are case insensitive, so when using a select or multi-select list for a notification scheme, JIRA-ADMINISTRATORS will match the jira-administrators group. This means you cannot have both a JIRA-ADMINSITRATORS and a jira-administrators option, as they have the same name.

How to filter users for user picker fields

NOTE: This option is only available for custom field types containing User picker (single user), not User picker (multiple user).

You can limit the set of users available in your user picker field to specific groups or project roles. To filter users, follow these steps: 

  1. Select the Jira icon (, or ) > Settings > Issues.

  2. In the Fields section, click Custom Fields.
  3. Find the custom field you want to configure and click  > Configure Edit User Filtering.
  4. Click Enable group or project role filtering, then specify the groups and roles that you want to limit the user picker to.
    The user picker will only show users that are in the groups and roles selected.
  5. Click Save.

How to use the Jira admin helper

The Jira admin helper can help you figure out why you can't see a custom field on one of your issue screens. To use the Jira admin helper, follow these steps: 

  1. Navigate to the View Issue, Edit Issue or Create Issue screen where the field is not showing.
  2. If you are viewing an issue, click More Actions > Where is my field? If you are creating or editing an issue, click Configure Fields > Where is my field?
  3. Enter the name of the field.
  4. Click Submit.
Last modified on Mar 22, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.