• Products
  • Documentation
  • Resources

Troubleshoot missing issues in your plan

This page refers to the advanced planning features that are only available as part of Jira Software Cloud Premium and Enterprise.

We have a separate section for documentation about the project timeline that’s included in all Jira Software projects. 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 how you can search for missing issues, the most common reasons and how to troubleshoot the causes.

Search for missing issues in your plan

The first step to finding why an issue isn’t showing in your plan is to search for it using the Find your issue function.

To find missing issues:

  1. Select Plan settings from the left side navigation.

  2. Choose Find your issue from the side navigation, then enter the missing issue’s entire key. This function doesn’t support partial matches.

If your issue is in your plan, you’ll see a message in a green box. If the issue is still missing from your plan, clear your filters to see if you can find it.

If your issue has been excluded, your plan tells you why you’re not seeing it. With this information in hand, you can now move to solving the problem.

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, your plan 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

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

  1. Select Plan settings from the left side navigation.

  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. your plan will automatically save your updates.

By default, your plan 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. Select Plan settings from the left side navigation.

  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:

  • your plan 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. Select Plan settings from the left side navigation.

  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. Select Plan settings from the left side navigation.

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

Additional Help