Troubleshoot missing issues in your plan

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

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 workflow

While Jira 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 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 workflow.

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. Find out 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 was excluded in the plan’s scope using exclusion rules

When creating a plan, you have the option to exclude issues based on criteria such as:

  • how long ago the issue was completed (by default, your plan excludes issues completed 30 days ago)

  • type of issue

  • the issue’s status

  • issues assigned to specific releases

Issues that meet these criteria are considered out of scope, and won’t be displayed in your plan. naturally, the way to bring them back in is to adjust your exclusion rules to re-include them.

To change the rule that excludes issues older than 30 days

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 automatically saves your updates.

By default, your plan excludes issues completed in Jira more than 30 days ago.

To change the rule that excludes issues based on age:

Select Plan settings from the left side navigation.Select Exclusion rules, then adjust the maximum number of days you want Done issues to show on your plan.

To change the rule that excludes issue types or issue statuses to 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

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.

One is to reschedule issues from an archived release to an active one.

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 removed from the plan

Planners can remove issues manually from your plan using the bulk actions menu. These issues are removed from the view of your plan, but can be re-added at any time, provided they meet the requirements of the exclusion rules. Read more about how to remove issues from your plan.

To restore issues that were manually deleted:

  1. Select Plan settings from the left side navigation. Then select Removed issues.

  2. Select the issues you want to restore to your plan. You can filter these issues by hierarchy level, or search for a specific issue using the search bar.

  3. When you’re ready, select Re-include to restore the issues in your plan.

Still need help?

The Atlassian Community is here for you.