Roadmap

Version history
  • Introduced in GitLab Ultimate 10.5.
  • In GitLab 12.9, Roadmaps were moved to the Premium tier.
  • In GitLab 12.9 and later, the epic bars show their title, progress, and completed weight percentage.

An Epic within a group containing Start date and/or Due date can be visualized in a form of a timeline (e.g. a Gantt chart). The Epics Roadmap page shows such a visualization for all the epics which are under a group and/or its subgroups.

On the epic bars, you can see their title, progress, and completed weight percentage. When you hover over an epic bar, a popover appears with its title, start and due dates, and weight completed.

roadmap view

A dropdown allows you to show only open or closed epics. By default, all epics are shown.

epics state dropdown

Epics in the view can be sorted by:

  • Created date
  • Last updated
  • Start date
  • Due date

Each option contains a button that toggles the sort order between ascending and descending. The sort option and order will be persisted when browsing Epics, including the epics list view.

Roadmaps can also be visualized inside an epic.

Timeline duration

Version history

Roadmap supports the following date ranges:

  • Quarters
  • Months (Default)
  • Weeks

Quarters

roadmap date range in quarters

In Quarters preset, roadmap shows epics which have start or due dates falling within or going through past quarter, current quarter and next 4 quarters, where today is shown by the vertical red line in the timeline. The sub-headers underneath the quarter name on the timeline header represent the month of the quarter.

Months

roadmap date range in months

In Months preset, roadmap shows epics which have start or due dates falling within or going through past month, current month and next 5 months, where today is shown by the vertical red line in the timeline. The sub-headers underneath the month name on the timeline header represent the date on starting day (Sunday) of the week. This preset is selected by default.

Weeks

roadmap date range in weeks

In Weeks preset, roadmap shows epics which have start or due dates falling within or going through past week, current week and next 4 weeks, where today is shown by the vertical red line in the timeline. The sub-headers underneath the week name on the timeline header represent the days of the week.

Timeline bar for an epic

The timeline bar indicates the approximate position of an epic based on its start and due date.