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:

What is an 'Issue Type Screen Scheme'?

An Issue Type Screen Scheme associates a Screen Scheme with issue types, allowing you to specify different Screens for the same operation (e.g. 'Create Issue') in the same project for issues of different types.

Adding an Issue Type Screen Scheme

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. Click the 'Issue Fields' sub-menu on the left hand side if it is not open already, and choose 'Issue Type Screen Schemes' from the list.
  4. This will bring you to the 'View Issue Type Screen Schemes' page:
  5. The 'Add Issue Type Screen Scheme' form is located at the bottom of the 'View Issue Type Screen Schemes' page.
  6. Enter the name for the new scheme.
  7. You can optionally add a description.
  8. Select a Screen Scheme for the Default entry in the new scheme. The Screen Scheme mapped to the Default entry will be used for issue types that do not have a specific mapping in the scheme.
  9. Click the 'Add' button. The screen will automatically update the Issue Type Screen Schemes list with the new Issue Type Screen Scheme.

Editing an Issue Type Screen Scheme

  1. On the 'View Issue Type Screen Schemes' page, click the 'Edit' link next to the selected Issue Type Screen Scheme.
  2. You will now be directed to the 'Edit Issue Type Screen Scheme' page where you can edit the Issue Type Screen Scheme's name and description as well as the Screen Scheme of the Default entry.
  3. Click the 'Update' button.
  4. You will be brought back to the 'View Issue Type Screen Schemes' page, with your updates now applied to the Issue Type Screen Schemes list.

Deleting an Issue Type Screen Scheme

  1. On the 'View Issue Type Screen Schemes' page, click the 'Delete' link next to the Issue Type Screen Scheme you wish to delete.
  2. Click the 'Delete' button to confirm this action.
  3. You will be brought back to the 'View Issue Type Screen Schemes' page, with the Issue Type Screen Scheme removed from the Issue Type Screen Schemes list.
Icon

Issue Type Screen Schemes that are associated with a project cannot be deleted.

Copying an Issue Type Screen Scheme

  1. On the 'View Issue Type Screen Schemes' page, click the 'Copy' link next to the field screen you wish to copy.
  2. You will now be directed to the 'Copy Issue Type Screen Scheme' page.
  3. Enter the name and description of the new Issue Type Screen Scheme.
  4. Click the 'Copy' button.
  5. You will be brought back to the 'View Issue Type Screen Schemes' page, and the newly added Issue Type Screen Scheme will have the same scheme settings as the original Issue Type Screen Scheme.

Configuring an Issue Type Screen Scheme

The configuration of an Issue Type Screen Scheme involves associating an issue type(s) with a particular Screen Scheme. For example, associating the 'Bug' issue type with the 'Default Screen Scheme' and then associating the 'Improvement' issue type with the 'Improvement Screen Scheme'.

To configure a given Issue Type Screen Scheme click the 'Configure' link next to the selected Issue Type Screen Scheme on the 'View Issue Type Screen Schemes' page. You will then be directed to the 'Configure Issue Type Screen Scheme' page:

Associating an Issue Type with a Screen Scheme

  1. The 'Add Issue Type to Screen Scheme Association' is located at the bottom of the 'Configure Issue Type Screen Scheme' page.
  2. Select an issue type you wish to associate a Screen Scheme with.
  3. Select the desired scheme.
  4. Click the 'Add' button and the new association will be added to the association list above.
Icon

There can only be one association for each issue type. If all issue types have been associated with a Screen Scheme you can use the 'Edit' link next to each entry to change the Screen Scheme that is associated with it.

Icon

If there is no specific entry for an issue type, the Screen Scheme associated with the Default entry will be used.

Editing an Association

  1. On the 'Configure Issue Type Screen Scheme' page, click the 'Edit' link next to the issue type you wish to edit.
  2. You will be brought to the 'Edit Issue Type Screen Scheme Entry' page:
  3. Select the screen whose association you wish to change.
  4. Click the 'Update' button and you will be returned to the 'Configure Issue Type Screen Scheme' page.

Deleting an Association

  1. On the 'Configure Issue Type Screen Scheme' page, click the 'Delete' link next to the issue operation you wish to remove.
  2. The association will be automatically removed from the table.
Icon

The Default entry is used for all issue types that do not have a specific entry in the scheme. It cannot be deleted.

Associating an Issue Type Screen Scheme with a Project

Once you have created and configured an Issue Type Screen Scheme to your desired settings, you can now associate the scheme with a Project. This will apply your chosen Screen Scheme to each issue type within the selected project.

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the Administration box on the dashboard.
  3. On the 'Administration' page is a list of projects which this user can manage. Select the project of interest.
  4. Click the 'Select Scheme' link beside the 'Issue Type Screen Scheme' caption:
  5. Select the screen scheme you wish to associate with this project.
  6. Click the 'Associate' button.
Icon

To control which issue types apply to a project, please see 'Associating Issue Types with Projects'.