Analyzing the usage of custom fields

Still need help?

The Atlassian Community is here for you.

Ask the community

This functionality is available with the Jira Data Center license. 

Having too many custom fields can clutter your Jira instance and affect its performance. It’s normal for these fields to grow over time as admins create testing fields and duplicates, and some fields are just no longer used. However, monitoring and cleaning up your fields is necessary to keep your instance quick and healthy. This page explains some of the tools you can use to analyze the usage of your custom fields to decide if they’re still needed.

For all of the following procedures, you must be logged in as a user with the Jira System administrator permissions. For details, see Permissions overview

Finding custom fields that are no longer used

To view all of your custom fields:

  1. In the upper-right corner of the screen, select Administration  > Issues.

  2. Under Fields (the left-side panel), select Custom fields.

The Issues column shows you the number of issues that store a value for your field and includes both issues with default values and archived issues.

A custom fields table with highlighted Issues column

Cleaning up

  1. Click the Issues column name to sort in ascending or descending order.

  2. Custom fields with a low number of issues are the most likely candidates for deletion. If you’re not sure if a field should be deleted or not, use other columns described here to make your decision.

Good to know

  • Data in the Issues column is refreshed once a day. You can see the date of the last refresh above the column ("Issues: last refresh…")

  • Data won’t be available for around 24 hours after the upgrade.

Finding custom fields that haven’t been updated for a long time

The Last updated column shows you the last time a value for a custom field has been added or updated in any issue, but it doesn’t include default values—as in, the user must actively choose or add a value for this field.

Cleaning up

  1. Filter your issues by Last updated to find custom fields that haven’t been updated for a long time. We consider two years to be quite old, but this will depend on you.

  2. Check the Issues column to see how many issues are using this field.

  3. If the fields are outdated, but still used in thousands of issues, this might mean they’re still important. If you’re not ready to delete them, you could improve performance by narrowing down their context only to the projects they’re used in.

Good to know

  • Data in this column is refreshed every hour, but the historical data about the usage of custom fields in existing issues won’t be available for around 24 hours after the upgrade. Any new updates you make after upgrading will be available right away.

  • If you’re importing a project or just need to recalculate this data as a fallback method, you can recalculate it in Jira advanced settings. To open the settings, go to Administration  > System and then select the Advanced settings button.

Comparing to other columns to help you make the decision

Issues and Last updated are the best tools to identify fields that are a bit rusty, but not all such fields should be deleted. Some of them might store data from your past projects that you’d like to keep for reference. This is where other columns should help you.

Contexts

Shows specific projects that can use this field or shows Global if the field is allowed for all projects. This should help you decide how important your field is.

Good to know

Screens

Shows the screens where your custom field is displayed, like a Create issue screen or Default issue screen. The number of screens using your custom fields, and what screens those are, should help you decide whether it’s really needed.

More information

If you’re on a mission to clean up your Jira instance and keep it that way, here are some useful pages:

Last modified on Apr 20, 2023

Was this helpful?

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