• Products
  • Documentation
  • Resources

Troubleshoot missing issues in your plan

This page refers to Advanced Roadmaps, which is a cross-project planning tool only available as part of Jira Software Cloud Premium and Enterprise.

We have a separate section for documentation about the project roadmap that’s included in all Jira Software plans. Go to the documentation for project-level roadmaps in Jira Software.

 

There are a few reasons why issues in your plan might not show as expected. This page explains the most common reasons for missing issues and shows you how to display them.

Issues from team-managed projects aren’t compatible with Advanced Roadmaps

As of right now, Advanced Roadmaps isn’t compatible with team-managed projects. If you have team-managed issues in your issue sources, they simply won’t show on your timeline.

Resolution field isn’t set in the Jira Software workflow

While Jira Software refers to an issue’s Resolution field to mark it as complete, Advanced Roadmaps refers to an issue’s status. When you’re using a default workflow, the Resolution field is automatically set when an issue is transitioned from the “In Progress” to “Done” status. 

If you’re using a custom workflow, this may need to be manually configured. Jira Software administrators can add a post function on the incoming transition for the status being used to signal a Done issue. Without this post function, completed issues in a custom workflow won’t be displayed in your plan.

Learn how to configure the Resolution field as a post function in your Jira Software workflow.

Issue was completed more than 30 days ago

By default, Advanced Roadmaps doesn’t display issues completed in Jira Software more than 30 days ago. You can adjust this timeframe to suit your planning needs.

To adjust the number of completed issues displayed in your plan:

  1. From the Roadmap view, navigate to settings using the  next to your plan name > Configure.

  2. Select Exclusion rules.

  3. Enter the number of days you’d like completed issues to stay in your plan in the Exclude any completed issues after field. Advanced Roadmaps will automatically save your updates.

By default, Advanced Roadmaps excludes issues completed in Jira Software more than 30 days ago.

The more completed issues you include in your plan, the longer it'll take to load.

Issue isn’t included in the plan’s issue sources

Issues in your plan are determined by the issue sources. Any issue source that’s not included is considered out of scope, and won’t be displayed in the plan. You’ll need to make sure the missing issue is included in an issue source for the plan’s scope.

To add or change the issue sources of your plan:

  1. From the Roadmap view, navigate to settings using the  next to your plan name > Configure.

  2. Select Issue sources. You can select a projectboard, or filter as the source of issues for your plan. If you’re adding a new issue source to a pre-existing plan, you’ll need to manually associate the team with the issue source to use capacity planning. Learn how to associate a team with an issue source.

When searching for a filter:

  • Advanced Roadmaps shows all results that contain your query. To search for a specific phrase, put quotes around your query.

  • add + between your search queries to include multiple filters

Issue’s release was excluded in the plan’s scope

Similar to issue sources, releases selected during plan creation determine if an issue is part of a plan’s scope. Any excluded releases and the issues assigned to them won’t be displayed in the plan.

To add a previously excluded release to your plan:

  1. From the Roadmap view, navigate to settings using the  next to your plan name > Configure.

  2. Select Exclusion rules and select View releases.

  3. Choose which previously excluded release you’d like to add back to your plan.

  4. Select Include.

Issue is included in archived release

Issues that are part of archived releases will be excluded from your timeline. There are two ways to fix this. The first is to reschedule issues from an archived release to an active one. Learn how to do this on the Releases page.

Alternatively, you can unarchive the release:

  1. From the Projects dropdown menu, select your project, then Releases from the left side menu.

  2. Using the dropdown menu next to the search bar, include Archived releases in your view. 

  3. Lastly, use the menu on the right to Unarchive your release.

Issue was manually excluded or removed from the plan

Depending on how your plan was first set up, specific issues may have been manually excluded based on type or status. When issues are excluded based on these criteria, they won’t be displayed in the plan regardless of their source or release.

To re-include an issue in your plan:

  1. From the Roadmap view, navigate to settings using the  next to your plan name > Configure.

  2. Select Exclusion rules, then adjust the Exclude issue types or Exclude statuses filters

Additional Help