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 or add contexts to custom fields, 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 > Issues
  2. Select Fields > Custom Fields.
  3. Select Add Custom Field. Select All to make sure you can see all available field types. 
  4. Select a field and click Next.
  5. 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.

  6. Select Create
  7. Choose which options to display and select Submit to finish adding your new custom field.

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 add-ons 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.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport