What is the roadmap?

This page is for company-managed projects

If the lower-left of your project sidebar says you're in a team-managed project, check out these team-managed project articles instead.

Learn more about the difference between company-managed and team-managed projects.

The roadmap is where you can create, manage, and visualize your team's issues. Roadmaps are useful for planning large pieces of work several months in advance and planning large groups of stories across different sprints.

Learn more about the benefits of roadmaps.

An annotated screenshot of the roadmap in a company-managed project. It displays the filters, and the view settings panel.

Here’s what you can do on your project roadmap:

  1. Filter issues on your timeline: Roadmaps lets you filter which issues appear on your timeline using a variety of criteria:

    1. Filter by issue summary: Find and refine your roadmap by searching for keywords. The filter narrows down your roadmap as you start typing as it matches your text input to the summary field on an issue. The filter applies to the epic and its child issues.

    2. Filter by assignee: Use this filter to see who’s doing what. This filter will automatically appear when you add an assignee to an issue. Select the avatar to only show work assigned to that person. If your roadmap is filtered by assignee, any new issue created on the roadmap will be assigned to the most recent selection.

    3. Filter by status category: This filter allows you to filter by a status category, either To do (represented as a grey status), In progress (represented as a blue status), or Done (represented as green status). The filter applies to the epic and its child issues.

    4. Filter by versions: This filter shows or hides issues based on the fix version to which they are assigned. Only versions that apply to at least one item on your roadmap will appear in the dropdown menu, excluding archived versions.

    5. Filter by label: Any label added to an issue on your roadmap will show up in this filter. Select one or more labels from the list to refine your view. If your roadmap is filtered by a label, then any new issue created on the roadmap will inherit the same label.

    6. Filter by issue type: If your team uses more than one issue type to sort work, you can filter the roadmap to view only a specific type. For example, you can filter to only show bugs or stories. This filter only appears if you’ve added more than one type of issue to your epics on the roadmap.

  2. View settings: A collection of settings that allow you to adjust your personal view of the roadmap. The settings only apply to you and although we remember your preference, you can change your view at any time.

  3. Epic display options: Use the dropdown to select which epics to display. The current options are: All, Incomplete, or Complete.

  4. Dependencies and progress: Add or remove dependencies and progress from your view. Learn how to manage dependencies on the roadmap.

  5. Timeline: Toggle to a specific timeframe, on the fly. Divide by weeks, months, or quarters.

Schedule bars for child issues are only currently available for scrum teams.

Individual issues only appear if you’ve added them to the epics on your roadmap. There are a few ways to add issues. Learn how to add issues to epics from the roadmap.

Last modified on Jul 12, 2021
Cached at 11:43 AM on Aug 4, 2021 |

Additional Help

Ask the Community