• Products
  • Documentation
  • Resources

Maintain epic link data for issues above the epic level

The information on this page is for Cloud customers only. Server and Data Center customers are not affected by these updates.

The processes outlined on this page can only be completed by a Jira admin.

We’re making changes to how you manage your issue hierarchy in Jira, allowing you to configure Jira to better reflect the way you and your teams work. Learn more about these changes.

As part of these updates, only issue types on the base-level (that’s the default level for stories, tasks and bugs) will be permitted to have an epic as their parent.

These changes are due to roll out from April 1st, 2022.

In company-managed projects, subtasks will continue to be able to be associated with an epic.

What you need to do

If you’re an Advanced Roadmaps customer that has epic links for issues above the epic level, you’ll need to update these epic links to ensure this relationship data is not lost.

The instructions below will help you determine which of your issues may be affected and how you can maintain your epic links.

If you do not address these epic links by April 1st, 2022, these epic link relationships may be lost.

View affected issues

You can use advanced search to view a list of affected issues using the following JQL, where <LIST OF ISSUE TYPES> is a comma-separated list of issue types that you want to check.

issuetype in (<LIST OF ISSUE TYPES>) and "Epic Link" is not EMPTY

For example, issuetype in (Feature, Initiative) and "Epic Link" is not EMPTY will return a list of Feature and Initiative issue types that have epic link data.

Learn more about advanced searching in Jira.

To view the issue types that sit above the epic level in your issue hierarchy: in the navigation bar, go to Plans > Settings, and then select Advanced Roadmaps hierarchy configuration from the sidebar.

The Advanced Roadmaps hierarchy configuration screen is available to Premium users only. If you don’t have access to this screen, you can sign up for a trial of Premium at no cost.

To manage your plan, choose Settings () >  Billing >  Manage subscriptions.

Navigating to the Advanced Roadmaps settings via the Plans dropdown

Maintain epic relationships

There are two approaches you can take to maintain the epic relationships on affected issues:

OR

Add the epic as a linked issue

You can maintain your epic relationships by changing them to different relationships using linked issues. Learn more about linking an issue.

Adding an epic as a linked issue
  1. Open the issue that you want to update the epic link for.

  2. Select Link issue.

  3. Choose the type of issue link, e.g. relates to.

  4. Specify the epic that you want to link to, by either:

  5. Select Link.

  6. Select the Epic link field and remove the epic.

Move affected issue types to the base level

Alternatively, if you wish to maintain your epic link data, you can move the affected issue types to the base level in your issue hierarchy. Learn more about configuring your hierarchy levels in Advanced Roadmaps.

Changing your issue hierarchy within Jira may invalidate existing parent and child relationships between your issues.

The Advanced Roadmaps hierarchy configuration screen is available to Premium users only. If you don’t have access to this screen and you’d like to complete the steps below, you can sign up for a trial of Premium at no cost.

To manage your plan, choose Settings () >  Billing >  Manage subscriptions.

Updating the issue hierarchy on the Advanced Roadmaps hierarchy levels screen
  1. In the navigation bar, select Plans > Settings, and then select Advanced Roadmaps hierarchy configuration from the sidebar.

  2. Locate and deselect the affected issue type(s) under the Jira issue types column. This will remove the issue type from its current level.

  3. Select Save changes.

Need more help?

If you have any questions, please contact our support team.

Additional Help