• Products
  • Documentation
  • Resources

Configure the issue type hierarchy

As a Jira administrator, you can configure your issue type hierarchy by changing the level names and structuring the hierarchy to your needs.

To view the issue type hierarchy settings:

  1. Select Setting > Issues.

  2. In the left column, go to Issue type hierarchy.

Changes to your issue type hierarchy will apply to all company-managed projects in your site.

Modify the default hierarchy levels

By default, Jira is set up with 3 levels of issue type hierarchy: Epic (level 1), Story (level 0) and Sub-Task (level -1). You can modify these levels to better reflect how your teams work.

Rename a hierarchy level

To rename a level in your issue type hierarchy:

  1. Click the level name that you want to rename.

  2. Edit the level name, and select Save changes.

Add issue types to the Epic hierarchy level

This is only available as part of Jira Cloud Premium and Enterprise.

Be default, the Epic issue type will be associated with the Epic hierarchy level (level 1). You can add additional Jira issue types to associate them with the Epic level. To do this:

  1. Select the Jira issue types field on the Epic level.

  2. Select from the list of available issue types or use the search field.

  3. Select Save changes.

Manage custom hierarchy levels

Jira Premium and Enterprise customers can also create and manage additional levels in their issue type hierarchy.

If you use Advanced Roadmaps, additional hierarchy levels can allow you to track your organization’s larger initiatives in your plans and unify cross-project work. Learn more about configuring the issue type hierarchy in Advanced Roadmaps.

Changing your issue type hierarchy will break existing parent and child relationships between your issues.

When you attempt to modify the existing structure of your issue type hierarchy, Jira will calculate the impact of these changes and require confirmation to proceed.

Please ensure that you understand the risks and impact of changing your issue type hierarchy before modifying its structure as once these changes are made, they cannot be undone.

If you need assistance during this process, contact our support team.

Create a new hierarchy level

To add a new level to the issue type hierarchy:

  1. Select + Create level at the bottom of the list of levels. A new level will be created at the top of the issue type hierarchy.

  2. Give your level a name, and use the dropdown in the Jira issue types column to associate it with an issue type(s).

  3. Select Save changes.

Remove a hierarchy level

To remove a level you have added to the issue type hierarchy:

  1. Locate the level you want to remove from your issue type hierarchy.

  2. Select Remove in the Actions column for that level. The level will be removed from the list.

  3. Select Save changes.

Any issue types that were associated with the removed level will default back to the Story level (level 0).

Additional Help