Custom Fields Health Checks

The Custom Field Health Check is a really useful tool, and we recommend using it regularly. It will help you ensure that the custom fields in your Jira instance are correctly configured and used.

The Custom Fields Health Check will run checks against a number of parameters:

Global custom fields

This checks for custom fields with a global context that are only used in a smaller set of projects and issue types. This allows you to identify any custom fields that can be optimized by restricting their context to only the projects and issue types where they are used.

You can find more information about custom field optimization here.

Several settings can be configured for this Health Check:

• Minimum number of issues:

  • The minimum number of issues the custom field has values in for the custom field to be considered optimizable. This allows you to ignore custom fields that are intentionally global but appear to have a local scope simply because they are newer and have not been fully adopted yet.

  • The default is 50 issues

• Maximum number of projects:

  • The maximum number of projects the custom field has values in for the custom field to be considered optimizable. This allows you to set the threshold at which custom fields are considered effectively global - it can be easier to manage custom fields with them having a global context instead of them having very large contexts with many projects.

  • The default is 20 projects

• Maximum number of issue types:

  • The maximum number of issue types the custom field has values in for the custom field to be considered optimizable. Again, this allows you to set the threshold at which custom fields are considered effectively global - it can be easier to manage custom fields with them having a global context instead of them having very large contexts with many issue types.

  • The default is 20 issue types

You can find more information about health check configuration here.

Unused custom fields

This checks for custom fields that do not have values in any issues and are therefore unused.