Associating field behavior with issue types
Note: For all of the following procedures, you must be logged in as a user with the Jira administrators global permission.
Adding a field configuration scheme
- In the upper-right corner of the screen, select Administration > System.
- Under Fields (the left-side panel), select Field configurations to view all your field configurations.
- Select the Add new field configuration scheme button to open the Add new field configuration scheme dialog box.
- Complete the Add new field configuration scheme dialog box:
- Name — enter a short phrase that best describes your new field configuration scheme.
- Description (optional but recommended) — enter a sentence or two to describe when this field configuration scheme should be used.
Select the Add button to add your new field configuration to Jira.
You will be redirected to the Configure field configuration scheme page, where you can start associating issue types with field configurations in your new field configuration scheme. See Modifying field behavior (from step 4) for details.
Associating an issue type with a field configuration
- In the upper-right corner of the screen, select Administration > Issues.
- Under Fields (the left-side panel), select Field configurations to view all your field configurations.
Select the Configure link for the field configuration scheme in which to create an association between an a field configuration and an issue type. The Configure field configuration scheme page will appear, showing the scheme's current mappings of field configurations to issue types.
If you have not added any new field configurations since installing Jira, you will only have Jira's Default field configuration to work with.
- Select Associate an issue type with a field configuration.
- Select the desired issue type and field configuration and click the Add button.
Note that:
- An issue type can only have one association within a given configuration scheme.
- If an issue type does not have an association in the scheme, the field configuration associated with the Default entry in the scheme will be used for issues of that type.
Removing an association between an issue type and a field configuration
- In the upper-right corner of the screen, select Administration > Issues.
- Under Fields (the left-side panel), select Field configurations to view all your field configurations.
Select the Configure link for the field configuration scheme that contains the association between a field configuration and issue type you want to remove. The Configure field configuration scheme page will appear, showing the scheme's current mappings of field configurations to issue types.
If you have not added any field configurations since installing Jira, you will only have Jira's Default field configuration to work with.
- Select the Remove link next to the issue type you wish to remove from the scheme.
The Default entry cannot be removed from the scheme.
Associating an issue type with a different field configuration
- In the upper-right corner of the screen, select Administration > Issues.
- Under Fields (the left-side panel), select Field configurations to view all your field configurations.
Select the Configure link for the field configuration scheme contains an association between a field configuration and issue type you want to change. The Configure field configuration scheme page will appear, showing the scheme's current mappings of field configurations to issue types.
If you have not added any field configurations since installing Jira, you will only have Jira's Default field configuration to work with.
- Select the Edit link next to the issue type whose field configuration you wish to change.
- Select the new Field configuration you would like to associate with this issue type.
- Select the Update button.
Editing a field configuration scheme
- In the upper-right corner of the screen, select Administration > Issues.
- Under Fields (the left-side panel), select Field configurations to view all your field configurations.
- Click the Edit link next to the field configuration scheme whose name and description you wish to modify.
- On the Edit Field Configuration Scheme page, edit the Name and Description of the field configuration scheme.
- Click the Update button.
Deleting a field configuration scheme
- In the upper-right corner of the screen, select Administration > Issues.
- Under Fields (the left-side panel), select Field configuration schemes to view all your field configurations.
- Select the Delete link next to the field configuration scheme you wish to delete. You will be prompted to confirm your deletion.
You can only delete a field configuration scheme that is not associated with a project. The Delete link will not be available for field configuration schemes which are associated with one or more projects.
Copying a field configuration scheme
- In the upper-right corner of the screen, select Administration > Issues.
- Under Fields (the left-side panel), select Field configuration schemes to view all your field configuration schemes (if any exist).
- Select the Copy link next to the field configuration scheme you wish to copy.
- On the subsequent page, specify the Name and Description of the field configuration scheme to be copied.
- Select the Copy button.
The (initial) associations between field configurations and issue types in both the original and copied field configuration schemes will be identical.
Associating a field configuration scheme with a project
To make your Jira projects use your field configurations, you need to associate these field configuration(s) with issue types in a field configuration scheme (above) and then associate this field configuration scheme with a project. (This association means that the field configuration scheme will be applied to the project.) Once this is done:
- The issues in this project will use the field configuration(s) "mapped" to their issue type (defined by the field configuration scheme associated with the project)
but also: - The issue types available to this project are defined by the issue type scheme associated with the project.
Therefore, even though a project's field configuration scheme may associate various different field configurations with a large set of issue types, only a subset of these issue types (as defined by the project's issue type scheme) and hence, field configurations themselves, may be available in that project. In other words, the issue types available to a project are restricted by the project's issue type scheme.
Newly created projects are not associated with any field configuration schemes and hence, use the Default field configuration for all issues.
To associate a field configuration scheme with a project:
- Access the Project summary administration page for your project (see Configuring a project).
- In the Fields section of this page, click the name of the current field configuration scheme.
- Select the Actions dropdown and choose Use a different scheme.
In the resulting page, select the scheme you want to associate with this project.
Selecting None will result in all issue types available to your project using Jira's Default Field Configuration.
Click the Associate button. You will be returned to the Project Summary administration page, with the project now associated with the selected field configuration scheme.