Manage epics in next-gen projects

Are you on the right help page?

The following information only applies to team-managed projects.

To check which type project you need help with, look at the bottom of your project’s left-hand sidebar:

Epics are used to describe a group of issues that all relate to the same, larger body of work. Epics are typically completed over several sprints, or a longer time frame if you don't use sprints. To learn more about epics and how they differ from other issue types, check out our guide on Epics, Stories, Themes, and Initiatives.

This page explains how to manage epics outside of your roadmap. However, we do recommend using your roadmap to manage your team's epics. Read our roadmap documentation to learn more. 

Create epics  

Outside the Roadmap, there are two ways to create epics:

Via the Backlog

  1. Select Backlog in the project menu on the left.
  2. On the Backlog, select the Version filter and enable the Epic panel toggle.
  3. Select + Create Epic.


Via the global menu

  1. From any project, click Create in the navigation bar.
  2. Under Issue Type, select your epic issue type (by default this is Epic, but it will be different if you've created your own epic issue type). Enter details and click Create.

View and edit epics

Outside of your roadmap, there are two ways to view and edit epics:

Via the Backlog

  1. Select Backlog in the project menu on the left.
  2. On the Backlog, select the Epic filter and enable the Epic panel toggle.
  3. Select the Epics you want to view/edit. Their details will appear to the right of the Epic panel. Click an Epic's chevron (>) in the panel to view and edit more details.

Via global search

  1. Click the search field in the navigation bar. If your epic doesn't appear in your list of Recent issues, select View all Issues.
  2. Use the filters to find and edit your epic.

Add issues to epics

Outside of your roadmap, there are two ways to add issues to epics:


Via the backlog

  1. Open your backlog's epic panel: Go to your project's backlog > Click the Epic dropdown filter > Click the Epic panel switch:
  2. Then select an epic and click + Create issue.

(info) Pro tip: Here you can also drag-and-drop issues from one epic to another. Hold Ctrl (Windows) or Command (Mac) to multi-select.


Via an issue

  1. From your board or backlog, hover over an issue and select more (•••). 
  2. Click Add parent (to assign the issue to an existing epic) or Change parent (to change the issue's epic). Issues can only belong to one epic at a time. 

(info) Pro tip: Hold Ctrl (Windows) or Command (Mac) to select multiple issues.

Note that classic project issues can only be added to classic project epics, and next-gen project issues can only be added to next-gen project epics.

Remove issues from epics

To remove an issue from its parent epic:

  1. Navigate to your board or backlog, or open an issue.
  2. Hover over the issue and select more (•••). 
  3. Select Change parent
  4. In the dropdown menu, select Remove.

Note: Removing an issue from its parent doesn't delete the issue from your project. The issue still exists, but it's no longer associated with the parent issue.

Learn more

Last modified on Jun 18, 2021

Was this helpful?

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