• Products
  • Documentation
  • Resources

Add or change issue sources in a 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.


In order to create and maintain an accurate plan, you must first tell Advanced Roadmaps where to find your issues in Jira Software. Advanced Roadmaps refers to this as an issue source.

An issue source is first defined while creating a new plan, though you can change or add another after plan creation.

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:

  • 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

Once added to your plan, you can set an exclusion rule to remove issues based on certain criteria. Learn more about exclusion rules and how to set them.

If you intend to use the capacity planning feature of Advanced Roadmaps, we recommend using boards as your issue source. A board includes all of the work assigned to a team as well as their backlog to give you a complete picture of their workload. As you plan future sprints for that team, Advanced Roadmaps takes that pre-assigned work into account and prevent you from exceeding their available capacity.

Additional Help