Defining issue type field values

Still need help?

The Atlassian Community is here for you.

Ask the community

Jira applications ship with a set of default issue types (epic, story, task, and sub-task) to help you get started. You can add, edit and delete your own custom issue types to suit the needs of your team. The diagram on Configuring issues shows how issue types relate to other entities in Jira applications.

You can also:

tip/resting Created with Sketch.

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 applications, 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 Configuring sub-tasks for details.

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. Select Issue types to view all issue types used by your Jira applications.
  3. Select Add issue type and enter the following details:
    1. Name — enter a short phrase that best describes your new issue type
    2. Description — enter a sentence or two to describe when this issue type should be used
    3. Type — specify whether the issue type you are creating is a Standard issue type or a Sub-task issue type. Sub-tasks are associated with individual Standard issues. Note that this option will not be available if sub-tasks are disabled.
  4. Select Add to create your new issue type. 
tip/resting Created with Sketch.

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 Associating issue types with projects.

Deleting an issue type

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.
  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. Select Issue types to open the Issue types page, which lists all 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

  1. In the upper-right corner of the screen, select Administration  > Issues.
  2. Select Issue types to open the Issue Types page, which lists all 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.

To reorder an Issue type, or set it as a default, see Associating issue types with projects.

Note that 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.

Last modified on Nov 16, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.