Create Custom Field

The Custom Field Creation Wizard (Figure 1, right) walks you through the process of adding a new custom field. To create a new custom field, follow these steps:

You are viewing the documentation for Jira Cloud.

  1. Log into your Jira instance as an Administrator.

  2. In the upper right corner, click Settings ( ) and select Apps.

  3. In the left-hand panel, click Jira Misc Custom Fields.

  4. Click My custom fields.

  5. In the upper right corner of the window, click New custom field. The Create Custom Field wizard will open.

  6. Name the custom field and, optionally, enter a Description (Point 1, Figure 1, right). The Name and Description will appear in the My custom fields administration screen.

  7. Select the type of custom field you want to create (Point 2, Figure 1, right). See Custom Fields for more information on the various types of fields that you can create.

  8. Click Next.

  9. Select the Jira screens to which the custom field should be added (Point 3, Figure 2, right). Screens can be added individually, or use the checkbox at the top of the column to select all screens. Additionally, the list of screens can be filtered using the search box at the top of the list. See Filtering Screens, below, for more information.

  10. Click Next.

  11. Set the configuration options for the field (Point 4, Figure 3, right). Depending on the type of field chosen the options will vary; refer to the specific field type documentation for more information on its options.

  12. Click Save.

A custom field can be added to additional screens and contexts after it has been created!

Note: custom fields are not currently supported on next-generation team management screens in Jira.

Your new custom field is now ready! When a custom field is first created, it is added to the Jira screens selected in the Wizard, but also to all contexts of your Jira project. If a custom field should only be available to specific issue types or specific projects (or a combination of these), you must update the configuration of the custom field. See https://support.atlassian.com/jira-cloud-administration/docs/configure-custom-field-context/ for more information.

Filtering Screens

When working with a Jira instance that includes a large number of screens, selecting each screen manually can be difficult. When associating a custom field with Jira screens, you can use the search box at the top of the list to filter which screens are displayed. When a filter is active, the search box will include a badge containing the number of screens matching the search string.

Figure 1 - Create Custom Field Wizard (Name and Type)
Figure 2 - Create Custom Field Wizard (Screen Selection)