Skip to main content

Epics

Epics let you organize and track larger initiatives by grouping related tasks together. Use them to plan features, track progress, and keep your work structured.

Overview​

  • Task Organization: Group related tasks under a single epic
  • Status Tracking: Track task progress with To Do, In Progress, Done, and Blocked states
  • Progress Summary: See at a glance how many tasks are complete
  • Search & Filter: Quickly find epics by name or description

Epics grid view with search and epic cards

Creating an Epic​

  1. Navigate to the Epics page from the sidebar
  2. Click the + button in the top-right corner
  3. Enter a Name (required) and optional Description
  4. Click Create

The new epic appears as a card in the grid view showing its title, description preview, status badge, and task count.

Create Epic dialog with name and description fields

Managing Tasks​

Each epic contains a list of tasks that represent the individual work items needed to complete the initiative.

Viewing Tasks​

Click on an epic card to open the detail view. You'll see:

  • The epic title and full description
  • A task summary showing total tasks and completion count
  • Each task with its title, description, current status, and a delete button
  • An Add Task button to create new tasks

Epic detail view with task list and status indicators

Task Statuses​

Each task has a status dropdown with four options:

  • To Do — task has not been started
  • In Progress — task is currently being worked on
  • Done — task is complete
  • Blocked — task is waiting on a dependency or issue

Click the status dropdown on any task to change its status. The epic's progress summary updates automatically.

Task status dropdown showing To Do, In Progress, Done, and Blocked options

Adding Tasks​

  1. Open an epic by clicking its card
  2. Click Add Task in the top-right corner
  3. Enter the task title and description
  4. The task is created with a default status of To Do

Deleting Tasks​

Click the trash icon next to a task's status dropdown to remove it from the epic.

Deleting Epics​

From the grid view, click the trash icon on an epic card to delete it and all its associated tasks.

warning

Deleting an epic permanently removes it and all of its tasks. This action cannot be undone.

Next Steps: Create an epic to plan your next feature, then break it down into trackable tasks!