How to safety delete custom fields in JIRA?

I'm trying to determine the best approach in determining whether a custom field is inactive. My thoughts is if a custom field is not associated to any screen, it is inactive.


Is there anything else I should check for before proceeding to deleting the custom field? 

5 answers

1 vote

I'm not sure that "not on a screen" is quite good enough.  I'd use the JQL

<field> is empty

In a couple of filter statistic gadgets to see exactly how it's used (by project is a good one)

Fields can also be used in workflow functions, which is a bit of a pain to find.

Hi Jerrin,

there is no safe way to delete a custom field. For example if you delete it the JQL filters will be broken, workflow post-functions or scripts that might reference the field will still referencing it. Here is what we recommend - there is an free add-on that scans your configuration and tells you if something is broken, including filters - Integrity Check for JIRA. It does not cover every add-on that you might use in the workflows but covers the most popular.

So the procedure is the following:

  1. Delete the custom field
  2. Run Integrity Check for JIRA
  3. Fix all issues reported
  4. Run JIRA Integrity Checker

98% you are all set, unless you use some other than the supported add-ons.

Peter T




0 votes
Joseph Pitt Community Champion Apr 14, 2016

In the definitions it shows what screens, projects, and issues it's related to and you can figure out what projects would have it. Run a filter to look for it and issue id in those projects to see if it was ever used.

You can check field's values before deleting using Custom Fields Usage plugin

 I recently removed a field and used the below method.
  • Find existing values: filter all work items using an example field value.
  • determine the work item types using the data.
  • In the affected workflows, check for scripts and conditions/validators that use the field, removing or modifying these steps.
  • Does the data entered in work items itself need saving? Will the loss affect the workflows?
  • If yes perform bulk update on existing work items as identified in the filter to update a new appropriate field that can match the values from the old field (if the number of changes is large you may want to do this when fewer people are using the system and making changes as the update can eat up your system memory).
    • If no simply delete the field, re-index and run the integrity check and ignore the next 4 steps.
  • Re-index the system. When doing this be careful, depending on the number of items affected, the system load and your available system memory this may cause slowness or service outage for some users unless you are running a "Lock JIRA and Re-build" index.
  • Run a simple walk through test of the work items that were updated to make sure there are no issues.
  • Delete the custom field.
  • Re-index the system and then run the integrity check to fix any issues.
  • Notify users of the field change in case their private filters used this field and are now showing errors.

Suggest an answer

Log in or Sign up to answer
Community showcase
Posted Oct 09, 2018 in Jira Core

How to manage many similar workflows?

I have multiple projects that use variations of the same base workflow. The variations depend on the requirements of the project or issue type. The variations mostly come in the form of new statuses ...

223 views 6 0
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you