Documentation for JIRA 4.4. 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.

Note that you can also:

On this page:

Creating an Issue Type

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Select 'Administration' > 'Issues' > 'Issue Types' to open the 'Manage Issue Types' page, which lists all issue types, along with a form underneath to add new issue types.
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'issue types'
    Screenshot 1: the Manage Issue Types screen

    (info) Please Note: You must Enable Sub-tasks to create a sub-task issue type.
  3. 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:
    Screenshot 2: the /images/icons directory
  4. Once you have created your new Issue Type, it will be automatically added to the Default Issue Type Scheme. You may want to also add it to other Issue Type Schemes — for more information, see Managing Issue Type Schemes.

Deleting an Issue Type

(warning) Before you begin:

  • If any issues of the Issue Type you are about to delete exist in your JIRA installation, please ensure this Issue Type has the following requirements (to ensure JIRA prompts you to choose a new Issue Type for those issues):
  • Alternatively, you can simply search for all issues that currently use the Issue Type which you are about to delete and perform a Bulk Move to change those issues to a different Issue Type.

To delete an Issue Type:

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. Select 'Administration' > 'Issues' > 'Issue Types' to open the 'Manage Issue Types' page (above).
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'issue types'
  3. Click the 'Delete' link (in the 'Operations' column) for 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. Select 'Administration' > 'Issues' > 'Issue Types' to open the 'Manage Issue Types' page (above).
    (tick) Keyboard shortcut: 'g' + 'g' + start typing 'issue types'
  3. Click the 'Edit' link (in the 'Operations' column) for the issue type that you wish to edit.

(info) Please 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.)