Edit or delete a custom field

Edit a custom field

  1. Select > Issues.
  2. Under FIELDS, select Custom fields.
  3. Find the custom field you want to edit and click  > Edit details to update the following:
    • The custom field name, which appears on issues.
    • The custom field description, which appears below the field on issues.

    • Search templates, which are responsible for indexing a custom field and making the field searchable in basic and advanced issue search. Custom fields come with a default search template, so you shouldn't need to change this setting.

  4. Modify the fields as needed and click Update.

You can also edit a custom field by clicking its screens or contexts link and then clicking Details > Edit Details.

You can't change the field's type (for example, making a single-select field into a multi-select field). To change a field's type, recreate the field using the desired type.

Jira allows you to define a description of a custom field. If the field configuration descriptions are left empty, then the original description text will appear when you create or edit an issue and as help text in the Issue Navigator. You can define different descriptions in each field configuration to override the description you added.

For example, if a custom field "My Field" is defined with a description of "This is my field" and no field configuration changes are made, then the displayed text will be "This is my field" as expected. If field configurations are used and a description "This is my excellent field" is set for the custom field in the field description, then the displayed text will be "This is my excellent field".

Delete a custom field

You may notice some custom fields created by your Jira products. We highly recommend that you don't delete these, because you won't be able to get them back.


  1. Select > Issues.

  2. Under FIELDS, select Custom fields.

  3. Find the custom field and click  > Delete to remove the custom field and any information entered in the field from all issues.

Last modified on Jan 31, 2020

Was this helpful?

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