Organizing Work with Epics
An epic is a large piece of work that can be broken down into tasks and issues. Epics let you group related work under a single theme, track high-level progress, and see how deliverables line up with a release.
Overview
Think of an epic as a feature area or major deliverable — something too big to complete in a single sprint, but useful as a grouping for many smaller tasks and issues.
| Concept | Scope | Time-bound? |
|---|---|---|
| Release | A product version or milestone | Yes |
| Sprint | A time-boxed work period | Yes |
| Epic | A thematic grouping of work | Optional |
An epic can optionally be attached to a release so you can filter and report by release version, and it may span multiple sprints.
Creating an epic
- In the left sidebar, click Epics.
- Click Create Epic (top-right).
- In the drawer, fill in the details:
- Name (required)
- Status — To Do, In Progress, Done, or Cancelled
- Priority — Low, Medium, High, or Critical
- Release (optional)
- Description
- Click Create to save.
Only admins can create, edit, or delete epics. Other members can view them and move items in and out.
Browsing and filtering epics
The Epics page shows four summary cards at the top: Total, To Do, In Progress, and Done. Below that you have:
- Search bar to find epics by name
- Filters button (funnel icon) — filter by one or more statuses, priorities, or releases
- Sort button — sort by Name, Status, Priority, Created Date, or Updated Date, ascending or descending
- View toggle — switch between List view and Board (Kanban) view
Active filters appear as chips you can remove one at a time, or clear with Clear all. Your filter and sort selections are remembered between visits.
Working with an epic
Click an epic to open its detail page. Across the top you see a segmented progress bar and five stat cards (Tasks, Issues, Done Tasks, Done Issues, Completion percentage). Four tabs let you work with the epic:
- Tasks — list all tasks in the epic. Click Create Task for a new one or Assign Existing Task to link an unassigned task.
- Issues — same pattern: Create Issue or Link Issue to connect an existing issue.
- Details — description and metadata (release, creator, timestamps).
- Activity — timeline of everything that has happened on the epic.
Admins see an Edit button in the header for changing the name, status, priority, release, or description. On the Board view you can drag an epic card between status columns to update its status.
Tips
- Use epics for themes that span sprints, such as "Checkout redesign" or "Q3 performance work".
- Attach an epic to a release to group all related work under that release.
- Status changes on an epic do not change the status of its tasks or issues.