What is a Portfolio plan

This information applies to Portfolio for Jira 3.0 and later. If you're using an earlier version (2.0 to 2.27) see the Portfolio for Jira live plans documentation.

Before you begin

For Portfolio for Jira to capture the latest and greatest data from Jira, you'll need to organize your work in Jira, into what we call issue sources in Portfolio. Portfolio first captures your Jira issues, and uses the corresponding issue details to create the ideal schedule for your teams. The issues can be scheduled across sprints, months, even years.

These are the issue sources in Portfolio, into which you'll have to organize your work in Jira:

  • Boards: A board displays issues from one or more projects, giving you a flexible way of viewing, managing, and reporting on work in progress. There are two types of boards in Jira:
    • Scrum board — for teams that plan their work in sprints
    • Kanban board — for teams that focus on managing and constraining their work-in-progress
  • Projects: A project in Jira is a collection of issues that is defined according to your organization's requirements. For example, it can be a software development project, a marketing campaign, or a website enhancement request system.
  • Filters: Your board's filter is a Jira issue filter (a JQL query) that specifies which issues are included on your board. For example, your board may include issues from multiple projects, or from only one project, or from a particular component of a project.

    Note that only the administrator of a board or a user with the Portfolio for Jira administrator global permission can configure a board's filter.

Out of the three (3) issue sources, we recommend that you use Scrum boards. This gives you the ability to manage sprints from those boards, plan the capacity of future sprints, and assign issues to sprints — all directly from your plan.

Portfolio plan overview

A Portfolio plan is essentially a roadmap of all the work that you manage in Jira. Work can be anything you're involved in — it can be the issues your teams are working on, the releases your teams have committed to delivering, and more.

Here's an example of a Portfolio plan:


Configure plan settings, like the name of your plan, or the issue sources your plan is using. You can also delete a plan from the settings icon.


Navigate to different views of your plan:

  • Roadmap, to see the issues in your plan, including issue details, and how these issues are scheduled for your team to work on.
  • Teams, to configure and manage the teams that are working across all the issues in your plan.
  • Releases, to configure and manage the releases associated with all the issues in your plan.

See Working with plans to know more about these views in your plan.


Filter work in your plan, so you're viewing only the work you need to see. You can filter your work by projects, releases, teams, and other filters.

See Viewing work and Filtering issues for more details.


The different sections in the roadmap view of your plan, where you can view and work on issues accordingly:

  • Scope, which displays the issues in the plan according to hierarchy levels. Expand a hierarchy level to see the issues of that level — and for each issue, the issue count (for each row), issue type icon, issue key, and issue summary are displayed. You can also create an issue in this section.
  • Fields, which displays the fields added to a plan as columns. Each column contains the corresponding issue details, as well as the corresponding issue actions.
  • Timeline, which displays issues in schedule bars, and the size of each bar corresponds to its start and end dates. You can schedule these issues by dragging and dropping the bars themselves. You can also adjust the start and end dates by dragging the corresponding end of the bar accordingly.
See Working with plans for more details.


Customize the view of the timeline, to make it easier for your audience to consume your plan. The following view settings are available:

  • Group by: Group your issues into separate swimlanes by assignee, project, or team.
  • Color by: Color your issues by status, team, or label, or by the corresponding values of any single-choice select and multiple-choice select custom fields being used in the plan.

See Customizing view settings for more information.


Perform actions for your plan:

  • Auto-schedule your plan, to let Portfolio assist you in scheduling your work, based on issue details from Jira, like assigned sprints, assigned releases, dependencies, dates, and more.
  • Share your roadmap, to share a read-only view of your roadmap to relevant stakeholders in your team. As an option, you can choose to embed the URL, so your consumers can embed your roadmap as needed. See Sharing roadmaps for more information.
  • Review changes in your plan, so you can select which changes you want to save in Jira, as well as which ones to discard from your plan.

As a best practice, make a habit of regularly reviewing and saving your changes in Jira. This way, you can inform stakeholders, keep the work items in Jira up to date, and ensure that your teams are ready to execute on your plan — all in real time.

Check out this video to see how to navigate a Portfolio plan in action.

Last modified on Mar 25, 2020

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.