Set up issue types in next-gen projects

descriptionIssue types categorize your project's work. Add your own or customize suggested issue types to distinguish, search, and sort the work your team takes on.

The following information only applies to next-gen projects

If you're unsure what type project you need help with, check the bottom of your project sidebar. If you see the Give feedback and Learn more menu items, you're in a next-gen project. If you don't, you're in a classic project.

Issue types distinguish different types of work in unique ways, and help you identify, categorize, and report on your team’s work across your Jira site. They can help your team build more structure into your working process.

By default, next-gen projects label all your tasks as either Task, if you chose to start with a Kanban project, or Story, if you chose to start with a Scrum project.

To view your project’s issue types: From your project's sidebar, select Project settings > Issue types.

Multiple issue types help you search and sort the work your team takes on, track the progress of specific types of work, even estimate how well your team responds to bugs or how fast they complete larger initiatives.

You can customize your issue types to match any method of project management you want. We recommend agile methodologies, and we provide suggested issue types to help you classify tasks to work in an agile way. 

You must have the administrator role in your project to do the things described on this page. Learn more about next-gen project roles.

Add suggested issue types to your next-gen software project

You can customize your issue types to match any method of project management you want. Jira Software recommends agile methodologies, and we provide suggested issue types to help you classify tasks to work in an agile way. Learn more about agile and how to run an agile software development project.

To add suggested issue types:

  1. From your project's sidebar, select Project settings > Issue types.
  2. From the sidebar, select + Add issue type.
  3. Choose one of the suggested issue types from the list.
  4. Select Add.

Your new issue type appears in the sidebar, alongside the other issue types your project uses. You can set an issue's type when you create a new issue in the project or on a board.

By default, next-gen software projects come with these suggested issue types:

Parent issue types

  • Epic. Agile teams use epics to track larger sections of work composed of smaller tasks, bugs and user stories. Jira uses the suggested epic issue type to power other features in next-gen projects, like roadmaps and reports. To use these features, you must use the suggested Epic issue type (and avoid creating your own custom issue type called "Epic"). Learn more about managing epics.

Standard issue types

  • Bug. Agile teams use the bug issue type to track problems with their software, such as user interface discrepancies, broken functionality, or other niggles experience by users.
  • Task. You can use the task issue type to categorize miscellaneous tasks – like technical investigations, administrative work, or other project-adjacent tasks.
  • Story. Agile teams use stories to capture feature requests and development work expressed as user goals.

Subtask issue types

  • Subtask. Sometimes work ends up being more complicated than you expected. Subtasks let you break down a bug, task, or story into smaller discreet tasks. Jira uses the suggested subtask issue type to power other features in next-gen projects like swimlanes on the board, and progress tracking while viewing an issue. To use these features, you must use the suggested Subtask issue type (and avoid creating your own custom issue type called “Subtask”). In next-gen projects, subtasks are called “children” of standard issues like bugs, tasks, or stories. Learn more about managing subtasks.

Create custom issue types in your next-gen software project

You can create your own issue types to truly customize how you track your project and the information you collect to carry out different types of work.

To add your own issue types:

  1. From your project's sidebar, select Project settings > Issue types.
  2. From the sidebar, select + Add issue type.
  3. Select Create issue type.
  4. Give your issue type a name, description, and an icon.
  5. Select Create.

Your new issue type appears in the sidebar, alongside the other issue types your project uses. You can set an issue's type when you create a new issue in the project or on a board.

Currently, you can only create custom "standard" issue types. You can't create custom "parent" or "subtask" issue types.

Edit issue types in your next-gen software project

Change an issue type's name

To edit the name of your issue type:

  1. From your project's sidebar, select Project settings > Issue types.
  2. From the sidebar, select the issue type you want to edit.
  3. Click the issue type's name and edit it how you like.
  4. Click Save changes.

Your issue type's name updates everywhere in Jira.

Change an issue type's description

To edit the description of your issue type:

  1. From your project's sidebar, select Project settings > Issue types.
  2. From the sidebar, select the issue type you want to edit.
  3. Click the issue type's description and edit it how you like.
  4. Click Save changes.

Your issue type's description updates everywhere in Jira.

Change an issue type's icon

Your issue type’s icon helps people scan and quickly distinguish between different types of tasks when they appear on your board, in search results, or in reports.

To edit the icon of your issue type:

  1. From your project's sidebar, select Project settings > Issue types.
  2. From the sidebar, select the issue type you want to edit.
  3. Click the issue type's icon.
  4. Upload a custom image or choose one from the list.
  5. Click Select.

Your issue type's icon updates everywhere in Jira.

Delete issue types from your next-gen software project

To delete an issue type:

  1. From your project's sidebar, select Project settings > Issue types.
  2. From the sidebar, select the issue type you want to delete.
  3. Select  Delete issue type.

If you have issues that use that type, we'll warn you about them. You'll have to change their type to something that you actually use in the project, or else things can break. Don't worry, Jira will walk you through how to update those issues, if needed.

Last modified on Feb 10, 2020

Was this helpful?

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