What is best way to delete unused custom fields from JIRA System ?

Hi ,

Recently we have deleted couple of un projects from our jira instance, but its configurations are still prasent in jira instance. So now we dicided to clean up all configuration metadata which is not used in system. As part of this excersise first we targeted custom fields, so what is best way to delete custom fields from jira instance and how to identify whether customfield is being used in any project or not ?.

4 answers

Hi Jonson,

in our environment we go from the big scheme towards the smaller configurations.

So here are our steps to "clean" jira:

  1. delete old/inactive Jira-Projects (archive xml, excel,attachments)
  2. workflows
    1. look at inactive Workflow-Schemes and delete them
    2. look at inactive workflows and delete them
  3. Screens
    1. look at issuetype-screen-schemes that doesn't have an assigned project and delete them
    2. look at fieldscreen-schemes that doesn't belong to any issuetype-screen-scheme and delete them
    3. tricky: look at fieldscreens which doesn't have any workflow or fieldscreen-scheme and delete them
  4. fields
    1. look at fieldlayout-schemes without a project and delete them
    2. look at fieldlayout without fieldlayut-scheme and delete them
    3. tricky: look at customfields without context and fieldlayout and delete them

Not easy and fast, but it works :-)
We are doing that "great cleaning" twice a year.

Hi Andre,

Do you have any automatic script to do the same.






0 vote

You can go to the issue navigator advanced searching and check if there are any issues using the custom field or not, using the following query.

"custom field name" is not EMPTY

If there are no results, the field is probably not used. If there are results, verify the validity.

I use "custom field name" is not EMPTY order by updated desc so I see the last time that anyone put a value in the custom field

This will not help to find issues from the projects where Permission Scheme doesn't grant you browse project permission/hidden with Issue Security

Andre Lehmann procedure it pretty similar to what I used in my instance.. To know which custom field is used I installed this plugin - https://marketplace.atlassian.com/plugins/pl.com.tt.admintoolsforjira.AdminToolsForJira. It was very helpful for me to delete couple of custom fields without digging into database.

Suggest an answer

Log in or Join to answer
Community showcase
Sarah Schuster
Posted Jan 29, 2018 in Jira

What are common themes you've seen across successful & failed Jira Software implementations?

Hey everyone! My name is Sarah Schuster, and I'm a Customer Success Manager in Atlassian specializing in Jira Software Cloud. Over the next few weeks I will be posting discussion topics (8 total) to ...

3,338 views 14 20
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
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot