Single-level epics were moved from GitLab Ultimate to GitLab Premium in 12.8.

When issues share a theme across projects and milestones, you can manage them by using epics.

You can also create child epics, and assign start and end dates, which creates a visual roadmap for you to view progress.

Use epics:

  • When your team is working on a large feature that involves multiple discussions in different issues in different projects in a group.
  • To track when the work for the group of issues is targeted to begin and end.
  • To discuss and collaborate on feature ideas and scope at a high level.

Relationships between epics and issues

The possible relationships between epics and issues are:

  • An epic is the parent of one or more issues.
  • An epic is the parent of one or more child epics. For details see Multi-level child epics.
graph TD
    Parent_epic --> Issue1
    Parent_epic --> Child_epic
    Child_epic --> Issue2

Also, read more about possible planning hierarchies.

Roadmap in epics (ULTIMATE)

If your epic contains one or more child epics that have a start or due date, a visual roadmap of the child epics is listed under the parent epic.

Child epics roadmap

Related topics