JIRA
Install
Admin
Use
Search JIRA documentation:

Defining New Issue Types

PDF
PDF

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

JIRA Professional and Enterprise editions also allow you to control the set of available Issue Types for each project — see Associating Issue Types with Projects. Additionally, JIRA Enterprise allows you to associate particular Issue Types with particular Fields, Screens and Workflow — for details see 'Associating Field Behaviour with Issue Types', 'Associating Screens with Issue Types' and 'Activating Workflow', respectively.

Creating, Editing and Deleting Issue Types

  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:

    Link to Administration sectionLink to Administration section

  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.

    Manage Issue Types Screen
  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:

    Directory view of icons dir in a JIRA webapp

    Once you create your new Issue Type, it will be automatically added to the Default Issue Type Scheme (in Professional and Enterprise Editions of JIRA). For more information, see Managing Issue Type Schemes.

You can edit and delete an existing issue type by clicking on the Edit and Del links on the right.

Ordering issue types and setting defaults

  1. 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).
    • In Standard Edition, you can choose the default issue type, and re-order issue types, by clicking on the link "Edit order and default issue type".
    • In Professional and Enterprise Editions of JIRA, it is possible to configure different sets of issue types for each project. Each set can have a different order and default issue type. Refer to Managing Issue Type Schemes for more information.
  2. Clicking on the "Edit order and default issue type" link will display the screen below. Here you can select the issue type that will be selected by default. If you don't select a default issue type, the user will see an option "Please Select..." when they're creating an issue.

    Setting defaults and reordering issue types
  3. To re-order the issue types, drag and drop the issue types into the correct order. Note that none of the changes are persisted until you click on the Save button. You can revert to the last saved changes any time by click on the Reset button. Clicking on Cancel will not save any changes.

    Drag and Drop