• Products
  • Documentation
  • Resources

Project timeline limits in Jira Software

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

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


While the timelineroadmap 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 timeline

The timeline view in Jira Software only shows issues of the Parent and Standard types. Child issues without a parent won’t be shown on your timeline. 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 timeline view. To view them on your timeline and to plan across multiple projects, you’ll need to use your plan 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 timeline 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 your plan, 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 timeline’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 timeline cannot exceed 5,000 issues

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

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

Additional Help