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. The diagram on Configuring Fields and Screens shows how issue types relate to other entities in JIRA.

Note that you can also:

Tip: You can quickly configure the workflow/screen design of an existing issue type for a project via the project administration page. See Defining a Project for details.

On this page:

Creating an issue type

When creating a new issue type in JIRA, you can create either a new standard or sub-task issue type. However, to create a sub-task issue type, you must Enable sub-tasks.

You can also create sub-tasks on the Sub-Tasks page. See Creating a sub-task issue type for details.

To create a new issue type:

  1. Log in as a user with the JIRA Administrators global permission.

  2. (tick)  Keyboard shortcut: g + g + start typing issue types
  3. Click the Add Issue Type button and enter the following details:
  4. Click the Add button to create your new issue type.
    (info) Your new issue type 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:

To delete an Issue Type:

  1. Log in as a user with the JIRA Administrators global permission.

  2. (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.
  4. Complete the fields

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. (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.
  4. Edit the Name, Description and/or Icon as described above for Creating an issue type.

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