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.

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 covers how to create and manage epics outside the roadmap. However, we highly recommend using the roadmap to create and manage your team's epics. Check out our roadmap documentation to learn more. 

Create epics 

  1. Navigate to your project.
  2. In the global menu, select +.
  3. 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).
  4. Enter any details you want and select Create.

View and edit epics

The easiest way to update an epic is by editing it on the roadmap.

To edit an epic without using the roadmap:

  1. Click your Jira icon () to navigate to the Jira home page.
  2. Select Filters.
  3. Select Search issues.
  4. Use the search options to find your epic.

Add issues to epics

  1. Navigate to your board or backlog, or open an issue.
  2. Hover over the issue and select more (•••). 
  3. Select Add parent

Issues can only belong to one epic at a time. If an issue already belongs to an epic, the option is replaced by Change parent

Classic project issues can only be added to classic project epics, and working with next-gen software projects issues can only be added to next-gen projects epics.

tip/resting Created with Sketch.

You can select multiple issues by holding Ctrl (Windows) or Command (Mac) and clicking issues to add multiple issues to an epic at once.

Remove issues from epics

To remove an issue from it's 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.

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