> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onestack.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Organize and track your work items with Epics

> Pro

Epics help you group related tasks into a larger work item, providing a hierarchical structure for managing complex projects. This feature is ideal for breaking down major objectives into smaller, manageable pieces while keeping everything organized within a project.

Use Epics when you need to:

* Organize tasks related to a larger objective or feature.
* Track progress and dependencies across multiple related work items.
* Improve visibility into how individual tasks contribute to broader goals.

<Check>
  Use an Epic for larger bodies of work that span multiple cycles and extend across different modules.
</Check>

## Turn on Epics[​](#turn-on-epics "Direct link to Turn on Epics")

<img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/enable-epics.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=19312c8ed6cdeb6651d4850c05c7127f" alt="Enable Epics" width="1658" height="681" data-path="images/core-concepts/issues/epics/enable-epics.webp" />

To start using Epics, turn on the feature for your project:

1. Go to the [Project settings](/core-concepts/projects/overview#project-settings) for the desired project.
2. Navigate to the **Epics** section on the right pane.
3. Click the **Enable** button.

Once turned on, the Epics tab will appear in the project's sidebar, giving you quick access to create and manage Epics.

## Add custom properties to Epics[​](#add-custom-properties-to-epics "Direct link to Add custom properties to Epics")

Custom properties allow you to add specialized fields to your Epics, helping you track additional information specific to your project's needs. These properties can be configured to capture various types of data.

<img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/add-custom-properties.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=c12d87ec5771329da430b7f6ae176689" alt="Add custom properties" width="3300" height="1586" data-path="images/core-concepts/issues/epics/add-custom-properties.webp" />

To add custom properties to an Epic:

1. Click the **Add new property** button on the Epics pane.

2. In the **Custom Properties** section, fill in the following fields:

   * **Title**: Enter a name for your property

   * **Description**: Add details about what this property represents

   * **Property type**: Select from the available options:

     * **Text**: For free-form text input
     * **Number**: For numerical values
     * **Dropdown**: For predefined selection options
     * **Boolean**: For yes/no or true/false values
     * **Date**: For temporal information
     * **Member picker**: For assigning team members

## Create Epics[​](#create-epics "Direct link to Create Epics")

<img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/create-epics.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=3e8ef9d320d9b4e30d2c6bf1d0eec3f7" alt="Create Epics" width="3294" height="1516" data-path="images/core-concepts/issues/epics/create-epics.webp" />

Follow these steps to create a new Epic:

1. Navigate to the **Epics** section under your project.

2. Click the **New Epic** button at the top right of the screen.

3. Provide the following details:

   * **Title**: Name your Epic.
   * **Description**: Add context for the Epic’s purpose.
   * **Properties**: Assign metadata like priority, assignees, labels, and due dates.

4. Click **Save** to create the Epic.

## View and manage Epics[​](#view-and-manage-epics "Direct link to View and manage Epics")

Once created, all Epics can be accessed from the **Epics** section under your project. The Epics screen provides a high-level view of all Epics within a project.

<img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/epics-screen.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=8687eaadaf00d161945071aad4a77ef5" alt="Epics screen" width="3822" height="1350" data-path="images/core-concepts/issues/epics/epics-screen.webp" />

<Check>
  To help you manage Epics effectively, Plane offers flexible sorting and filtering options.
</Check>

Clicking on an Epic opens a detailed view where you can quickly view and manage an Epic without leaving your current context.

### Add work items to Epic[​](#add-work-items-to-epic "Direct link to Add work items to Epic")

<img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/add-issues.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=984f190a258820ad34b7ec4e882f3c79" alt="Add work items to Epic" width="3340" height="1198" data-path="images/core-concepts/issues/epics/add-issues.webp" />

You can add existing work items to the Epic or create new ones directly from the Epic.

<Warning>
  An work item can belong to only one Epic. This ensures clarity in organization and avoids overlapping tasks across multiple Epics.
</Warning>

### Work items list and relations[​](#work-items-list-and-relations "Direct link to Work items list and relations")

<img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/issues-and-relations.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=13d519620ab3f8c6b59858b88f29218d" alt="Work items and Relations" width="1917" height="823" data-path="images/core-concepts/issues/epics/issues-and-relations.webp" />

* See the full list of work items grouped under the Epic.
* Add or remove work items from the Epic.
* Manage work items directly by updating their status, assignee, or priority.

### Epic progress[​](#epic-progress "Direct link to Epic progress")

<img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/epic-progress.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=ff6586502bd43d9df1b9769cd7497020" alt="Epic progress" width="3010" height="1204" data-path="images/core-concepts/issues/epics/epic-progress.webp" />

You can track Epic progress visually with a color-coded progress bar that shows:

* Task completion status (e.g., Backlog, Started, Completed).
* Work item counts and completion percentage for each status category.

### Properties, comments, and activity[​](#properties-comments-and-activity "Direct link to Properties, comments, and activity")

* View and update the Epic’s key properties like assignee, priority, timelines, and other custom properties. <img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/epic-properties.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=05b2489156fd608e97b49416b2cccc71" alt="Epic properties" width="1916" height="650" data-path="images/core-concepts/issues/epics/epic-properties.webp" />

* Add comments to collaborate with your team and to discuss progress, blockers, or updates. <img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/epic-comments.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=1a6a43a37918217a87fbea29c0ffda1c" alt="Epic comments" width="3334" height="1200" data-path="images/core-concepts/issues/epics/epic-comments.webp" />

* Access the activity log for a history of changes made to the Epic, ensuring transparency and accountability. <img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/epic-activity.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=cf3563ec050775183e3d04086e0e4892" alt="Epic activity" width="3404" height="850" data-path="images/core-concepts/issues/epics/epic-activity.webp" />

## Link Work items to Epics[​](#link-work-items-to-epics "Direct link to Link Work items to Epics")

For each work item, you can assign or change a work item's Epic directly in the **Parent** property.

<img src="https://mintcdn.com/onestack/fY1zi8d7j4Z_n-Sg/images/core-concepts/issues/epics/link-issue-epic.webp?fit=max&auto=format&n=fY1zi8d7j4Z_n-Sg&q=85&s=3443a07ef81126e306fc16af6ca7bff4" alt="Link Work items to Epics" width="2508" height="1578" data-path="images/core-concepts/issues/epics/link-issue-epic.webp" />

***

Epics provide a simple yet powerful way to manage larger goals while keeping your projects organized and your team aligned.
