The roadmap
Epics on a timeline, with dependencies, and an optional public roadmap for people outside the team.
Roadmap, or a project's Roadmap tab
The roadmap shows your epics on a timeline, with each epic's progress worked out from its child issues. Use it to see what is planned when, which epics depend on each other, and which chain of work sets the finish date. You can also publish a read-only version for customers and other people outside the team.
Open the roadmap
- Roadmap in the sidebar shows epics from every project you can see.
- A project's Roadmap tab shows that project's epics, plus its sprints and releases along the top of the timeline.
Switch between Timeline and List at the top. Epic creates a new epic.
Put an epic on the timeline
- Open the epic and set both its Start date and its Due date.
- To add work to an epic, open each story or task and set its Parent issue to the epic.
An epic without both dates is listed under the timeline as unscheduled, with a link to each one, so it doesn't disappear.
Read and change the timeline
- Zoom by Month or Quarter. A vertical line marks today.
- Each bar shows the epic's progress: the share of its child issues in a done status. Hover a bar for its percentage and dates. A bar past its due date and not at 100% turns red.
- Drag a bar to move both dates, or drag one edge to change only the start or the end. Dates snap to whole days.
- Or choose the calendar icon next to an epic (Change dates) to type its Start and Due dates in a small dialog.
- On a project's roadmap, sprints are drawn as bands along the top and releases as ticks: on their ship date if shipped, otherwise on their target date.
Dependencies and the critical path
When one scheduled epic blocks another (an issue link set on the epic), the timeline draws an arrow between them. The roadmap then works out the critical path: the chain of dependent epics that decides when the whole plan finishes. Those bars are outlined. A day lost on them is a day lost overall. See Sub-issues and links to add a blocking link.
The list view
List shows each epic with a progress bar, how many of its child issues are done, its total story points, and the child issues themselves with their status and points.
Publish a public roadmap
- Go to Settings → Workspace. You need permission to change workspace settings.
- Under Public roadmap page, tick Enable public roadmap page.
- Optionally, choose a project in Suggested ideas go to so visitors can suggest new ideas. Leave it on Nowhere — no suggestion form to turn suggestions off.
- Choose Save changes. The page's address appears under the checkbox: it is
/public/your-workspace-slug/roadmap.
What visitors see
- Roadmap: every epic in the workspace's public projects, with its title, project name, start and due dates, and its progress percentage (the share of its child issues that are done). Issue keys and individual child issues are not shown.
- Vote on an epic: the visitor gives an email address and, optionally, why it matters to them. Each email counts once per epic. Voting again updates what they said. The team sees votes and comments on the epic itself, under Customer feedback.
- Suggest an idea, when a project is chosen for ideas: each idea becomes an issue in that project. If Triage is on in that project, the idea waits there for someone to accept it. Visitors aren't told the issue key or the project.
- Changelog: every shipped release in a public project, newest first, with its name, version, ship date and the titles of the issues in it.
When the page is off, its address shows a not-found page, so nobody can tell whether the workspace exists.