Defining New Issue Types
| 
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
- Log in as a user with the 'JIRA Administrators' global permission.
-
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:


-
On the panel on the left, under the title "Issue Settings", click on the link labelled "Issue Types".
-
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.
-
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
(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
-
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.
-
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.
-
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.