Skip to main content

How to schedule work in the shared PI plan with Advanced Roadmaps

Learn how to use the Configured PI plan and prepare the Jira epic PI roadmap in Jira Cloud.


Before executing a PI planning event, teams need to complete a few prerequisites. To prepare the Jira epic PI roadmap, the Jira admin and PI plan admin need to complete the PI plan in Jira configurations, and the product team members need to use the views and filter options to complete all the jobs to be done.

Advanced Roadmaps has a lot of capabilities and can be a new experience for many existing Jira end-users. We recommend the Planning with Advanced Roadmaps University course as a primer to following the guidance in this how-to article.


In Jira, use the Jira epic-only project and board to prepare Jira epics for the upcoming PI. If you don't already have a regular "Definition of ready" practice, we suggest completing the following steps to prepare Jira epics in the program board or Jira epic board:
  1. Navigate to your program board with Jira epics.
  2. Refine the Jira epics according to your "Definition of ready" working agreement. At a minimum, we recommend updating the following key fields:
    1. Program increment
    2. Contributing team(s)
    3. Business value assigned using WSJF (reassign WSJF in PI plans using the WSJF view)
    4. Status = ready
    5. Business target date
    6. Estimate (t-shirt or points)

      Please note: These field values can be adjusted in the plan views, especially if other features from other sources appear in the PI plan.

  3. Drag and drop the epics to set the rank for the PI.
    Eppic read KB1
    Drag and drop epics to set the rank.
  4. Move Jira epics on the board to the ready column as needed.
In plans, use the pre-configured views to further refine all the targeted features and prepare for the PI planning event. If all the how-to configuration guidance has been followed in the Prepare PI planning guide, you should see the following views:
AR Views 2
  1. Navigate to the PI plan created by your PI plan admin.
  2. Select the target epics to PIs view. This is the main view and will ultimately be used for presenting the feature roadmap during the PI planning event.
    timeline 3
  3. To refine any of the field values, simply update them directly in the plan.
    1. To update WSJF, use the WSJF view.
    2. Use business requested date to communicate your desired due date.
    3. To reassign the Jira epic to a different PI, update the PI field. You can't drag and drop between folders.
    4. To reprioritize, drag and drop issues.
    5. To align the PI plan with investment or strategic goals, use the high-level planning view. This is also a good view to review the PI priorities with your leadership team.
      1. Adjust the target start and target end dates for the initiatives.
      2. Confirm that the Jira epics business requested date is targeted within the initiative's start and end dates.
        timeline 4
  4. Be sure to frequently click on review changes and save changes to issues in Jira.
    1. We recommend you make saving changes to issues a regular practice, especially before switching between views. Remember, even a drag-and-drop change must be saved so the rank field is updated on the issue in Jira.

Do not update or save changes to any of the preconfigured views without discussing them with your PI plan admin. Pre-configured views help scale cross-team coordination efforts by maintaining standards and governance. If needed, create your own views with alternate filters and columns to prepare your features.
Remember, you can adjust view settings to help make informed decisions about dates and prioritization.
After using your own views or view settings, make sure your plans are represented in the pre-configured views.



  • Jira epics are scheduled in the shared PI.


Was this content helpful?

Connect, share, or get additional help

Atlassian Community