Adding a custom field

Jira applications let you add custom fields in addition to the built-in fields. When creating a custom field, you can choose between Standard and Advanced types. For standard types, a preview image is shown for each type, so you can see what you are creating in advance. This ensures that you get the custom field you want, much faster. To configure search templates use the Configure option on each custom field.

Custom fields are always optional fields. This means that you can create a new custom field without requiring existing issues to be changed. The existing issues will contain no value for the new custom field, even if a default value is defined.

For all of the following procedures, you must be logged in as a user with the Jira Administrators  global permission.

Adding a field directly to an issue

Jira Admins can add an existing field or create a custom field while in View Issue with the Admin > Add field option. You can even configure the options for that custom field without having to leave the screens you are presented with.

Adding a field using the Add Custom Field button

  1. Choose Administration () > Issues
  2. Select Fields > Custom fields.
  3. Select Add custom field
  4. In Select a Field Type, select All to make sure you can see all available field types. 
  5. Select a field type and click Next.
  6. Configure the selection criteria for your field, as shown in the example for the Checkboxes field below:

    The Field Name will appear as the custom field's title in both entering and retrieving information on issues, whereas the Field Description is displayed beneath the data entry field when entering new issues and editing existing issues, but not when browsing issues.

  7. Select Next
  8. Configure the context for your custom field and click Create.

You can limit the issue types for which this custom field displays to, for example, only Tasks.

Next steps

If you wish to change the context or other variables in your custom field, see Configuring a custom field. You can also find more custom fields from apps listed on the Atlassian Marketplace (e.g. the Jira Toolkit). To build your own custom field types, see the tutorial at the Jira Developer Documentation.

tip/resting Created with Sketch.

Do more with Jira

To help you add custom fields to Jira, use one of the apps available on the Atlassian Marketplace:  

Last modified on Mar 22, 2021

Was this helpful?

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