Skip to content

Epics

An epic in SetGet represents a large body of work that is too big to complete in a single cycle. Epics capture strategic initiatives — a major feature launch, a platform migration, a compliance overhaul — and break them into smaller work items that are delivered incrementally across cycles and modules.

Epics sit above individual work items in the planning hierarchy. While a work item represents a single task, an epic represents a goal that requires many tasks to achieve. Epics give leadership and product managers a high-level view of progress without needing to track every individual task.

Why use epics

  • Strategic visibility — see how large initiatives are progressing at a glance, without drilling into individual work items.
  • Cross-cycle tracking — epics persist across cycles, giving you a unified view of work that spans multiple sprints.
  • Scope management — define what is in and out of scope for a major initiative, and track how much has been delivered.
  • Stakeholder communication — share epic progress with stakeholders who need to understand the big picture without the granular details.
  • Prioritization — compare epics side by side to decide where to focus team effort.

Create an epic

  1. Navigate to the Epics section from the project sidebar.
  2. Click the + button or the Create Epic action.
  3. Fill in the epic details:
FieldRequiredDescription
NameYesA clear name for the initiative, such as "Multi-Workspace Support" or "Mobile App V2"
DescriptionNoDetailed context including goals, success criteria, stakeholders, and scope boundaries
Start dateNoExpected start date for the initiative
End dateNoTarget completion date
PriorityNoUrgency level for the initiative
LeadNoThe person accountable for driving the epic to completion
LabelsNoTags for categorization and filtering
  1. Click Create to save the epic.

TIP

Write a thorough description for every epic. Include the business goal, success metrics, key deliverables, and known risks. Epics often last weeks or months, so a well-written description prevents context loss as the team evolves.

Epic properties

Epics carry a rich set of properties that help you plan and communicate:

PropertyDescription
NameThe title of the initiative
DescriptionRich text context and specifications
Start dateWhen work on the epic is expected to begin
End dateThe target delivery date
PriorityUrgency relative to other epics
LeadThe accountable person
LabelsCategorization tags
StateDerived from child work item progress or set manually
ProgressAutomatically calculated from child item completion

Add work items to an epic

Epics contain work items as children, forming a parent-child hierarchy:

From the epic view

  1. Open the epic.
  2. Click Add work items to search and select existing items, or click Create work item to add a new one directly under the epic.

From a work item

  1. Open any work item.
  2. In the properties panel, set the Parent field to the target epic.

From the list view

  1. Right-click a work item or use its action menu.
  2. Select Set parent and choose the epic.

Work items nested under an epic can simultaneously belong to a cycle and a module. This means you can plan "when" (cycle) and "what feature area" (module) while still tracking "which initiative" (epic).

Epic progress tracking

SetGet automatically calculates epic progress based on the state of its child work items:

  • Completion percentage — the ratio of completed child items to total items, displayed as a progress bar.
  • State distribution — a breakdown showing how many items are in each workflow state (Backlog, In Progress, Done, etc.).
  • Estimate rollup — if work items have estimates, the epic shows total estimated effort and how much has been completed.

The progress bar on the epic list provides an at-a-glance view of how close the initiative is to completion.

Progress calculation

MetricCalculation
Completion %(Completed items / Total items) x 100
Remaining effortSum of estimates for non-completed items
Completed effortSum of estimates for completed items
Items at riskItems past due date that are not completed

Epic timeline view

Epics can be visualized on a timeline to understand how initiatives overlap and relate to one another:

  • Each epic appears as a horizontal bar spanning its start and end dates.
  • Child work items are displayed beneath the epic bar, showing their individual timelines.
  • Color coding indicates progress — green for on-track, amber for at-risk, red for behind schedule.
  • Drag bar edges to adjust epic dates directly on the timeline.

The timeline view is especially useful for portfolio-level planning and stakeholder presentations.

Manage epics

Edit an epic

  1. Open the epic from the sidebar or list.
  2. Click the ... menu and select Edit.
  3. Modify any field — name, description, dates, priority, lead, or labels.
  4. Save your changes.

Archive an epic

  1. Open the epic and click the ... menu.
  2. Select Archive.
  3. The epic is hidden from the active list but can be restored later.

Delete an epic

  1. Open the epic and click the ... menu.
  2. Select Delete and confirm.

Deleting an epic removes the grouping but does not delete its child work items. The items remain in the project with their parent field cleared.

WARNING

Deleting an epic is permanent. If you want to keep a record of the initiative, use archive instead.

Epics vs modules vs cycles

Understanding where epics fit in the planning hierarchy:

AspectEpicsModulesCycles
ScopeStrategic initiativeFeature areaTime-boxed sprint
DurationWeeks to monthsVariable1-4 weeks
ContainsWork items (parent-child)Work items (grouping)Work items (grouping)
OverlapMultiple epics can run in parallelMultiple modules in parallelOne active cycle at a time
Primary use"Why" — the strategic goal"What" — the feature"When" — the delivery window

A single work item can have an epic as its parent, belong to a module, and be assigned to a cycle — all at the same time.

You can filter and search epics using:

  • Text search — find epics by name or description keywords.
  • Filter by priority — show only high-priority or urgent epics.
  • Filter by lead — see epics owned by a specific team member.
  • Filter by label — narrow down to epics with specific tags.
  • Filter by status — show active, completed, or at-risk epics.
  • Filter by date — find epics starting or ending within a date range.

Epic permissions

Epic management follows project-level role permissions:

ActionAdminMemberGuest
Create epicYesYesNo
Edit epicYesYesNo
Delete epicYesNoNo
Add/remove itemsYesYesNo
View epicYesYesYes
View progressYesYesYes

Best practices

  • Keep epics strategic — an epic should represent a meaningful initiative, not just a collection of related tasks. If an epic has fewer than five work items, it may be too granular.
  • Define success criteria — include measurable outcomes in the epic description so you know when it is truly complete.
  • Break down early — decompose epics into work items as soon as possible so that progress tracking starts early.
  • Review regularly — check epic progress in weekly or bi-weekly planning meetings to catch slippage early.
  • Limit active epics — too many active epics dilute focus. Keep the number of concurrent epics manageable for your team size.
  • Use timeline view for planning — visualize how epics overlap to avoid resource conflicts.
  • Close completed epics — archive epics when they are done to keep the active list focused on current work.