Documentation for JIRA 4.1. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata

On this page, we show you how you can configure your custom field after you've created them.

Configuring Custom Fields

For most custom fields, you can configure its default values and set the options for lists. When you click on the configure link, you'll be faced with a page similar to the one below.


You'll notice that there is a configuration scheme named Default Configuration Scheme for.... This is the configuration scheme created automatically by JIRA when you initially added your custom field. The Applicable contexts for scheme refers to context that this scheme will be applied to; which projects & issue types the defaults and options will be displayed. For most people this will be only thing you need to know about custom field configuration schemes. You can edit the context by clicking Edit configuration or the edit icon on the top left hand corner.


Here you can edit the label and description of the configuration scheme. These are used for administrative purposes only and isn't shown to the end users. You can also change the context that this scheme is to be applied to here. It's now easier than ever to change the projects or issue types for the configuration context.


Select lists, multi select lists and cascading selects lists can have their options manipulated. You can add, remove and sort the options alphabetically. You can also have HTML in an option value. Be sure to use complete all tag pairs and ensure that it will display correctly.


Click the Edit defaults to modify the default value of a custom field for this configuration scheme. Setting the defaults of will take you to a screen that is particular to the issue type. Certain custom fields such as calculated custom fields may not allow for defaults to be selected and will not have the "edit defaults" link.

Managing multiple configuration schemes

Since JIRA 3.2, it is now possible to configure a custom field differently for different issue types and project combinations. This can be achieved through configuring different custom field schemes.

  1. Click on the Add context link to create a new custom field configuration scheme.
  2. You'll see a screen that very similar to the edit configuration scheme. Here you can select the applicable context for your new configuration scheme. One difference is that the project context will only show projects and options that have not be previously selected in another configuration scheme. So if you already have an existing "Global" configuration scheme, that option will not be available. Moreover, be aware that project specific configuration scheme will override Global configurations. For example, if you have one global configuration scheme with one default value and a project configuration scheme with a different value, the project value will be used instead.
  3. Click Add
  4. You will now have a new configuration scheme that can be reconfigured separately to the default scheme. You can add different default values and options for each one. In the screen show below, the Database custom field have specialised options and defaults for two to the projects, which will over-ride the global options list.

Additional Resources

  • Adding a custom field tutorial video - Watch this short tutorial video to see how to add and configure a new custom field. Please note the JIRA version and JIRA edition of the tutorial video before watching.