Set up Jira Software Cloud
Learn how to set up Jira Software Cloud and integrate it with other products and applications.
Troubleshoot the roadmaps for team-managed projects
This page includes solutions to problems commonly found in team-managed projects.
Go here to see solutions to common problems related to company-managed projects
For teams using team-managed projects, here's some common errors and what you can do to troubleshoot them from your roadmap:
Accidentally converted a child issue type to a parent issue type
I can’t see my project roadmap. Instead, it says “Roadmaps are designed for a single project”
Board filter exceeds issue limits
The roadmap view of Jira Software can only show 5,000 issues at once with no more than 500 being at the parent level.
The roadmap automatically excludes issues if they were:
moved to the Done status category more than a year ago
moved to the Done status category, and it has a due date from more than a year ago
To only display issues created within the last year:
From your project, select Issues and filters > Advanced search.
In the search bar, enter this query, but replace:
NAME with the name of your project
DATE with the dates you’d like to focus on
1
project = NAME AND created >= DATE AND created <= DATE
Your roadmap contains corrupt issues
An issue is considered corrupt if certain details, like the issue type, status, status category, or rank settings are invalid. The details might have been missing when the issue was created or something might have gone wrong with a bulk import.
The roadmap won’t display until the details in the corrupt issue are fixed.
To fix a corrupt issue, you must raise a support ticket. Our team will help fix the issue so you can continue using your roadmap.
No parent issue type in project
In order for a roadmap to show, your project needs to have an issue configured as an epic issue type. If this issue type has been deleted from your project, the roadmap won’t show.
To check whether your project has an epic issue type configured:
Select > Issues, then select Issue types from the left menu.
In the Type column in the middle of the page, look for issues that are labeled as Epic.
If you don’t find one, you’ll need to configure an epic-type issue. Learn how to edit and create issue types in Jira Software.
Alternatively, parent issues could be excluded from your JQL query. To resolve this, your board admin needs to edit the filter query in the Board settings to include parent issues.
No values in date fields on parent issue type
Parent issue types must have a Start date and Due date set to display on the Roadmap. If these dates are cleared out, navigate to the issue in your backlog, and reschedule it.
Accidentally converted a child issue type to a parent issue type
If you've mistakenly converted a standard issue type to a parent issue type, restore them to their original state with the following steps:
Delete the 'wrong' epic type (the one that was converted).
As part of the issue type deletion process, you'll be asked to which new issue type you'd like to move all your issues.
Select the new issue type you created.
Rename this new issue type to your old one, if you want to.
I can’t see my project roadmap. Instead, it says “Roadmaps are designed for a single 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.
Was this helpful?