Learn how to set up Jira Software Cloud and integrate it with other products and applications.
Learn how to configure your existing Jira Software Cloud site to suit your agile development processes.
Learn how to create, search, and work with issues in software projects, manage your profile, and more.
Learn how to get started, enable features, and manage and administer next-gen projects.
Create powerful rules to start automating your manual, repetitive processes.
Manage epics in a scrum project
Are you on the right help page?
The following information only applies to classic projects.
To check which project you need help with, look at the bottom of your project’s left-hand sidebar:
If you see an icon stating You’re in a next-gen project with Give feedback and Learn more menu items, you're in a next-gen project. Check out our next-gen project documentation.
If you don’t, you're in a classic project.
Before you begin
The functions for managing epics require different permissions. For example, you need the 'Edit Issues' permission to add an issue to an epic. Read Permissions overview for more information.
Go to the Backlog of your Scrum project.
Click EPICS on the left side of the board (aligned vertically) to open it.
Add a new epic
Click Create epic (you will need to hover over the 'EPICS' panel to show this link), enter the epic details, and create it.
Update an epic's details
For the epic name, click the arrow next to the name, then choose Edit name.
Change an epic's color on the board
Click the arrow next to the epic's name, then choose the color from the menu.
Add an issue to an epic
To add an existing issue, drag and drop the issue onto the epic in the 'EPICS' panel.
Remove an issue from an epic
Drag and drop the issue onto Issues without epics in the 'EPICS' panel.
Alternatively, view the detailed view of the issue on the board, locate the Epic field, then click the 'x' in the epic name lozenge (this method also works in the Active sprints of a board).
Filter issues by epic
Click the epic in the 'EPICS' panel to show only issues in that epic. Click All issues to remove the filter. Alternatively, click Clear all filters next to the sprint's name.
Complete an epic
Click the arrow next to the epic's name, then choose Mark as Done from the menu. This will set the epic's Epic Status field to "Done", but will not affect the epic's workflow or its Status field, and none of the epic's issues will be affected.
Viewing an epic in a scrum backlog
Note that the blue horizontal bar under an epic's details (in the 'EPICS' panel) indicates progress towards completing the work estimated for the issues added to the epic. This bar only represents progress on the estimated issues in an epic.
Need help? If you can't find the answer you need in our documentation, we have other resources available to help you. See Getting help.
Was this helpful?