• Products
  • Documentation
  • Resources

Project roadmap limits in Jira Software

This page refers to the roadmap view in Jira Software and not Advanced Roadmaps, the cross-project planning tool only available as part of Jira Software Cloud Premium and Enterprise.

Unless otherwise noted, the roadmap view in Jira Software is the same for both company-managed and team-managed projects.

While the roadmap view of your project is a useful tool for planning future work, there are limits on what it can show and requirements on how your project must be structured.

 

Only Parent and Standard issue types show on your roadmap

The roadmap view in Jira Software only shows issues of the Parent and Standard types. The default Parent issue type in Jira Software is epic, and the default Standard types are story and task. Learn more about issue types in Jira Software.

Subtasks, which are below Standard, and any custom hierarchy levels above Parent created by Jira Software Premium users won’t show on your project roadmap view. To view them on your roadmap and to plan across multiple projects, you’ll need to use Advanced Roadmaps which is included as part of Jira Software Premium and Enterprise subscriptions. Learn more about higher hierarchy levels in Advanced Roadmaps.

All issues need to come from one project

Commonly, teams running a company-managed project create boards with a custom JQL query to monitor issues from multiple projects. However, the roadmap view in Jira Software only works with issues from the backlog associated with one project. If you’re using a custom JQL filter that draws in issues from multiple boards, adjust it to only include issues from one project. Learn how to adjust your JQL filter.

Cross-project planning is only possible in Advanced Roadmaps, which is included with Jira Software Premium and Enterprise. Learn more about how Advanced Roadmaps helps you plan across multiple teams.

An epic issue type must exist and be included in your project via JQL

Jira Software comes with a default issue hierarchy structure which includes the issue type epic. Your administrator can create a custom hierarchy level and name it whatever your organization calls tasks at that level.

However, if this epic-level task is hidden from the roadmap’s issue source, whether through accidentally deleting the issue type or it’s filtered out through a JQL filter, you’ll see the same warning as above.

Your roadmap cannot exceed 5,000 issues

Your project roadmap can’t show more than 5,000 issues total, and the number of parent issues is capped at 500. The roadmap won’t load if your project exceeds these limits.

Modify your board JQL to reduce the number of issues that show on your roadmap.

Additional Help