• Products
  • Documentation
  • Resources

Project timeline limits in Jira

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

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


While the timelineview 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 is epic, and the default standard types are story and task. Learn more about issue types in Jira.

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. Read about higher hierarchy levels in plans.

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. Read how plans gives an overview of the work of multiple teams and projects.


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 in 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