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

Skip to end of metadata
Go to start of metadata

JIRA ships with a set of default 'Issue Types' to help you get started. Everyone's needs are different and so JIRA also allows you to add, edit and delete your own custom Issue Types.

On this page:

Note that you can also:

Creating an Issue Type

  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 panel on the left, under the title 'Issue Settings', click on the link labelled 'Issue Types'.
  4. This will bring up the 'Manage Issue Types' page. The page lists all issue types, along with a form underneath to add new issue types.
  5. To add a new Issue Type, fill in the Add New Issue Type form. For the 'Name', enter a short phrase that best describes your new Issue Type. For the 'Description', enter a sentence or two to describe when this Issue Type should be used. For the 'Icon URL' you need to supply the path of a 16-by-16-pixel image that has been placed somewhere inside JIRA's opened .war. We suggest you place it in /images/icons:

    Once you create your new Issue Type, it will be automatically added to the Default Issue Type Scheme. For more information, see Managing Issue Type Schemes.

Deleting an Issue Type

Before you begin:

Icon

So that JIRA can prompt you to choose a new Issue Type for any issues that are currently using the Issue Type which you are deleting, please ensure that the Issue Type which you are deleting is associated with:

Alternatively, you can simply search for all issues that currently use the Issue Type which you are deleting, and do a Bulk Move to change them to a different Issue Type.

To delete an Issue Type,

  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 panel on the left, under the title 'Issue Settings', click on the link labelled 'Issue Types'.
  4. This will bring up the 'Manage Issue Types' page (as shown above). Click the 'Del' link at the right of the issue type that you wish to delete.

Editing an Issue Type

To change the Name, Description or Icon for an Issue Type:

  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 panel on the left, under the title 'Issue Settings', click on the link labelled 'Issue Types'.
  4. This will bring up the 'Manage Issue Types' page (as shown above). Click the 'Edit' link at the right of the issue type that you wish to edit.

Note: To reorder an Issue Type, or set it as a default, see Associating Issue Types with Projects. (Reordering issue types changes the order in which they are displayed to the user who is creating an issue; and the default issue type is the one that is displayed in the selection-box --- see Creating an Issue.)