Learn how to set up Jira Software Cloud and integrate it with other products and applications.
Learn how to configure your Jira Software Cloud company-managed projects to suit your agile development processes.
Learn how to create, search, and work with issues in software projects, manage your profile, and more.
Learn how to get started, enable features, and manage and administer team-managed projects.
Create powerful rules to start automating your manual, repetitive processes.
Plan and view work across multiple teams, projects, and releases with Advanced Roadmaps.
A guide on how to deploy and monitor an application built on AWS using Atlassian and third-party tools.
Sometimes a project, or the epics and issues it contains, can prevent you from accessing the roadmap.
Board filter exceeds issue or epic limit
The roadmap displays all issues and epics in your board filter. If your board filter contains more than 3000 issues or 300 epics, the roadmap won’t display.
To help clear the clutter there’s also a filter built into the roadmap, and it automatically excludes epics if they meet these specific criteria:
The epic is Marked as done in Backlog > EPICS on the left side of the board.
The epic was moved to the Done status category more than a year ago.
The epic was moved to the Done status category, and it has a due date from more than a year ago.
It's good practice to set due dates on your epics, so you’re reminded to mark them as done or adjust the due date. You can find the Due date field in the epic issue view. If it's not visible, an admin might need to configure your issue detail view.
A board admin can also adjust the board filter to only display recent work.
To only display issues created within the last year:
Go to Projects then select the relevant project.
Select Issues and filters > Advanced search.
In the search bar, enter this query, but replace NAME with the name of your project. Adjust the dates to match the current year:
Manage corrupt issues
An issue's 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 epic issue type
If your project doesn't have an epic issue type, the roadmap won't display. Note that the issue type must be a high-level issue type, so a regular issue type that happens to be called "Epic" still won't work. To fix this, add a new epic issue type, or select an existing issue type and designate it as the epic issue type. Learn more about issue types.
Epics don’t display on the roadmap when using a Kanban board
The roadmap is based on the same JQL filters as your board. If you’re using a Kanban board, it’s likely that your board will have a JQL filter that prevents epics from displaying on the board. The query could look like this:
project = FOO and issueType != Epic ORDER BY Rank
To display epics on your roadmap, your board admin can remove the JQL query from the board filter, and add it to the Kanban board sub-filter instead.
To adjust your JQL filter:
If you’re not already there, navigate to your company-managed project.
From your board, go to More (···) > Board settings.
In the General tab of your board settings, find Filter > Saved filter. Select Edit filter query.
From your Filters settings, remove (or cut) this clause: issueType != Epic. Run the search, then save your changes.
Return to the General tab of your board settings. Find Filter > Kanban board sub-filter.
Edit the query by hovering over the text. Paste the and issueType != Epic clause into the field.
Select Update to save your changes.
My sprints aren’t showing on my Roadmap
In order for a sprint to show along the top of your Roadmap, it must be from the same backlog or rapidviews as the Roadmap. Sprints from other boards won’t show up.
The sprints also have to have dates set (such as closed sprints, active sprints, or a scheduled future sprint) that fall within the previous one year or the next two years. Anything outside this date range won’t be shown.
Accidentally converted a story-level issue type to an epic
If you've converted another issue type to an epic, and your issues no longer display on the board and backlog, you can restore these issues to their original state:
Create a new story-level issue type.
Delete the 'wrong' epic type (that was converted).
As part of the issue type deletion process, you'll be asked which new issue type you'd like to move all your issues to.
Select the new issue type you created.
Rename this new issue type to your old one, if you want to.
Recently completed issues not showing on your roadmap
If recently completed issues aren’t showing on your roadmap, ensure that the Due Date field is visible in your issue view. If it’s hidden, recently completed issues won’t be visible on your roadmap.
To check if Due date is visible in your issue view, use the Find your field function:
You must be an admin to use Find your field on the issue view.
To find a field on the issue view:
Open an issue.
Select ··· > Find your field.
Search for the field you want to find.
Select the field.
If the field is hidden, Jira generates a warning. To fix this and surface the Due date field in your issues:
Navigate to Settings -> Issues
Select Field Configurations from the column on the left, then select the scheme you wish to edit.
Search for Due Date in the search box or find it in the list, then select Show.
If Due Date is already enabled in your instance, you won’t see the Show option.
Was this helpful?