Set up issue types in next-gen projects

Still need help?

The Atlassian Community is here for you.

Ask the community

description Issue 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.

Issue types categorize your project's work and help identify different types of work across your Jira site. 

By default, next-gen software projects label all your tasks as Story ().

Add more issue types to your project to distinguish different tasks in unique ways. Multiple issue types help you search and sort the work your team takes on. 

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

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.

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.

Next-gen software projects come with these suggested 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 enabling agile features.
  • 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.

Create custom issue types in your next-gen software project

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.

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

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 Aug 19, 2019

Was this helpful?

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