Topics in Program board:
- About this report
- Navigation
- Prerequisites
- How are report values calculated?
- Report views, actions, and functions
-
How to interpret this report
About this report
The program board may seem to be a simple scheduling and tracking board, but it is far more than that — it is an agreement between product management and the development teams on what functionality will be delivered at various points of the upcoming or current PI.
The program board displays the status of features, dependencies, objectives and milestones through symbols and color-coding.
Note: While the program board is a "living document" with the ability to move features, dependencies, and objectives between sprints, organizations that perform planning with the entire program before program increments begin should only need to make minimal updates. In fact, if you see the feature delivery shifting out of early sprints and see many features due in the final two sprints, this is an indication of an immature and/or unhealthy program.
Navigation
You can access the Program Board from multiple locations:
- Select Programs in the top navigation bar and select the program you want to view information about.
- On the sidebar, select Program board in the list of page options.
OR
- Select Programs in the top navigation bar and select the program you want to view information about.
- In the program room, select View Program Board from the Sprints section of the page.
Note: After navigating to the page, you can use the Extra Configs to filter by additional programs and/or teams.
Prerequisites
- A program increment (PI) must exist in the system and be tied to a program.
How are report values calculated?
No additional calculations or algorithms are used in the report. All status information is pulled from the corresponding work item and its field values. See color-coding for an explanation of what conditions cause different colors to be displayed on the report for features, dependencies, objectives, and milestones.
Report views, actions, and functions
Use the Extra Configs button in the top-right corner to filter the work items displayed on the page by product, release vehicle, and more.
The program board has three different views with varying levels of detail. To change the view type, select the change view icon from the upper-right corner of the page and choose one of the following options:
-
Normal View: All work items are displayed on the board as cards with their IDs and titles displayed. Color-coded status is highlighted on the left of each card. Dependencies, objectives, milestones, and split features are notated with the corresponding symbol in the upper-right corner of a card.
Note: Because dependencies are associated with both a Requesting and a Depends On team, dependencies may be listed on the board twice: once for the Requesting team, and once for the Depends On team. If the Depends On Team is in a different PI than the Requesting Team, the dependency will appear for the Depends On Team in the column that best matches the anchor dates of the Requesting team’s PI.
-
Small View: All work items are displayed on the board as their corresponding symbols with their IDs displayed.
Note: Because dependencies are associated with both a Requesting and a Depends On team, dependencies may be listed on the board twice: once for the Requesting team, and once for the Depends On team. If the Depends On Team is in a different PI than the Requesting Team, the dependency will appear for the Depends On Team in the column that best matches the anchor dates of the Requesting team’s PI.
-
Heat Map View: All work items are displayed on the board as sized-down versions of their corresponding symbols with IDs displayed.
Note: Because dependencies are associated with both a Requesting and a Depends On team, dependencies may be listed on the board twice: once for the Requesting team, and once for the Depends On team. If the Depends On Team is in a different PI than the Requesting Team, the dependency will appear for the Depends On Team in the column that best matches the anchor dates of the Requesting team’s PI.
In any view, you can rank your teams to change the order that teams display. To rank teams:
- Click Team Rank in the top-right of the Program Board to open the Team Ranking window.
- In the Program drop-down menu, select the program you’d like to rank teams within.
- A list of teams in the program display. You can drag and drop teams within the list to change their order.
- Once the teams have been reordered, click the X icon at the top of the Team Ranking window to close it. The Program Board automatically updates to display the new team ranking.
Hover over any item to see more details display in the lower-left corner of the board. ID, Name, and State fields are displayed. If applicable, any planning issues will be indicated by the presence of red or orange color blocks.
Select any item displayed on the board to display its Quick View slide-out panel. Some fields are editable depending on the type of item selected and your permissions. More details on any planning issues are listed at the top of the panel. See feature Quick View fields for more information.
To display the full item editor slide-out panel, select the highlighted name of the item from the top of the Quick View panel. You can edit most item fields from the resulting display.
Visually change a feature’s target sprint
The program board allows you to move features across sprints to visualize when a team should deliver their stories or standalone feature. This is useful for both upfront and continuous planning methodologies. Managers and planners in an organization will manually move features into sprints for each team during planning meetings or ceremonies.
When a feature is first added to the board – either through creating or editing a related story and assigning it to a relevant team and sprint, or by manually adding an orphan feature – it will be found in the Unplanned Sprint column.
You will need to change the Team Target Completion Sprint field of a feature to move it to a sprint on the board:
- Select a feature to open its Quick View slide-out panel.
- From the Team Target Completion Sprint drop-down, select the desired target sprint from the available selections, and then close the panel.
Notes:
- Edits to this field from the program board results in a visual change only and will not impact a feature's Target Start and Target Completion.
- Features on the board do not inherit their sprint assignments from a feature’s Target Start/Completion fields, nor the status of related stories. The board view is independent from sprint fields on work items.
- Edits to the Team Target Completion Sprint field can be viewed on the Program Board Feature History Report.
Add, remove, and view orphan features
In Jira Align, orphan features refer to features that do not have any child stories. The program board will display an orphan feature under two different scenarios:
- Features without stories can be manually added to the board. The added orphan feature will display in the Unplanned Sprint column and associated team swimlane.
- A feature may be assigned to a team that does not own any of the feature’s child stories. For example, if Team A is assigned to a feature while Team B owns all of its stories, you will see the feature displayed twice: an orphan feature in Team A’s swimlane, and a non-orphan copy feature in Team B’s swimlane.
To manually add an orphan feature to the program board:
- Click the More Actions button at the top-right of the page.
- Select Orphans from the drop-down; the Program Orphans dialog box displays.
- Using the drop-down menus at the top of the Program Orphans dialog box, select a program and a PI that contains the orphan feature; optionally, you can also select a theme and epic.
- In the Search bar, search for the name, ID, or tag associated with the orphan feature you want to add.
- Once the desired orphan feature is found, use its Select one or more Teams… drop-down field to select the team(s) assigned to the feature.
- Click the Update button.
- Close the dialog box; the orphan feature is added to the Unplanned Sprint column for the specified team(s).
To remove an orphan feature from the Program Board:
- Click the icon that represents the orphan feature to be removed; the Feature slide-out panel displays.
- Click the Add/Remove from Board button found in the Target Sprint section.
By default, the Program Board only displays orphan features assigned to a team. To view orphan features that are not assigned to a team:
- Click the Extra Configs button at the top-right of the page.
- Turn on the Show Unassigned Features option, and then click Apply.
Important: If this option is turned on, you cannot manually add orphan features to the Program Board from the More Actions menu. Turn off this option to restore the ability to add orphans again.
View a full-screen presenter view of the Program Board by selecting the full-screen icon from the upper-right corner of the page. Select the full-screen icon again while in the presenter view to revert to the normal view.
Select the Capture button in the upper-right of the page to create a screen capture to share and discuss the board with other team members and stakeholders.
The program board contains a subreport, Feature History, that provides a log of scheduling edits made to features. When a feature’s schedule is modified, the report indicates the user who made the update, the start sprint, the end sprint, and the time stamp when the modification was made.
To access and generate this report:
- Click the More Actions menu on the top-right of the page, and then select History; the Program Board Feature History dialog box displays.
- Click the blue plus + icon to display all available filters. Filter the report by specifying the following feature parameters: Program, Dates, Program Increments, Epic, and/or Tags.
- Click the Run Report button; results display at the bottom.
An overall scan of the program board will quickly give a feel for the health of the program increment for the selected program or team. Sharing and communicating what's on the board also provides insight to product owners, release train engineers, and other stakeholders about the outcomes of PI planning, and potentially when features will be completed.
Report legend and symbols
Click the Legend icon in the upper-right corner of the page to access a full list of definitions of symbols and color-coding used by the report.
The program board displays four types of items, each represented with a shape:
- Hexagon - Objective
- Rectangle – Feature
- Rectangle with right-side highlight – Parent of split Feature
- Rectangle with left-side highlight – Child of split Feature
- Bowtie - Dependency
- Diamond – Milestone
The status of each item is team specific and color-coded as follows:
Green -
Done. All work is finished on the item (feature, dependency, objective). A green feature means all stories are completed, but it has not yet been accepted by the product management team.
- Features:
- Marked as Done.
- All child stories are accepted.
- Dependencies:
- Marked as Done. Alternatively, dependencies will appear green if they have been committed and the Committed In sprint has not ended.
- All associated stories are accepted.
- Objectives and milestones:
- Marked as Completed.
Check mark -
Accepted by the product management team. Checkmarks may display regardless of item color.
- Features:
- Marked as Accepted.
- All child stories are accepted.
Red tab in corner -
Accepted with planning issues. Symbol is green with a checkmark due to acceptance and done status, but would otherwise be colored red or orange due to planning issues.
- Features:
- Marked as Accepted.
- All child stories are accepted.
- At least one child story is not assigned to any team.
- The feature has one or more stories not assigned to any sprint (in the unassigned backlog).
- There are conflict dependencies with the feature.
Gray -
Not started. No work has begun on the object in question.
- Features:
- Child stories are assigned to teams and proper sprints, but sprint or work has not begun.
- Objectives and milestones
- Marked as Pending.
Blue -
In Progress.
- Features:
- Any child story within the feature is in progress. This works only when there are no stories blocked, unassigned to a timebox, or unassigned to any teams.
- A story has a dependency and this story is assigned to a sprint that did not pass yet.
- Objective or milestone is marked as In Progress or On Track and/or its date has not passed yet.
Yellow -
Risks apply.
- Features:
- Risks exist with the Open state from a ROAM model.
- Objectives and milestones:
- Objective or milestone has an associated risk that is in the Open state of the ROAM model.
Orange -
Planning issues.
- Features:
- At least one child story is not assigned to any team.
- The feature has one or more stories not assigned to any sprint (in the unassigned backlog).
- Dependencies:
- Dependency has no entries set in the Requested In or Committed In sprint fields.
- No stories are assigned to a dependency.
- Dependency is not committed to and its program increment has not begun.
- Dependency was rejected.
- Objectives and milestones:
- Marked as Paused.
Red -
Blocked.
- Features:
- At least one of child stories of the feature is blocked by an open impediment.
- A dependency associated with a feature is red.
- A feature's status is set to Blocked.
- Child stories are assigned to teams and proper sprints, and the sprint dates are in the past.
- Dependencies:
- Dependency is not committed to and its program increment is in progress.
- Dependency is committed, but the Committed In sprint has ended.
- Marked as Blocked.
- A sprint is past the Requested In or Committed In sprints.
- Any of the stories associated to a dependency have impediments and are blocked.
- Objectives and milestones:
- Objective or milestone has an open associated impediment.
- Marked as Blocked.
- Marked as Missed.
- Associated feature has a red dependency.
- Associated feature or story is blocked or has impediments.
- Associated dependency is red.
Brown -
Cancelled.
- Objectives and milestones:
- Marked as Cancelled.
Black -
Orphan status.
- Features:
- Feature has no child stories.
The arrow icon, or , inside of a dependency symbol indicates that the dependency is requested by or dependent on a team that is in a program outside of the program specified on the board.
- When the arrow icon displays pointing to the left, the dependency is requested from an outside program team.
- When the arrow icon displays pointing to the right, the dependency is requested from a team inside the current program, and depends on a team that is part of an outside program.
The links icon inside of a feature symbol indicates that the feature is dependent on something, or something depends on it.
- When the links icon displays with a left-hand arrow, the feature is a predecessor with successors.
- When the links icon displays with a right-hand arrow, the feature is a successor with predecessors.
- When the links icon displays with arrows on both sides, the feature has both predecessors and successors.
Create and manage links to other work items from the Work Item Links page.
The following fields are available in the Quick View panel for features:
- Feature ID and name: A clickable link that opens the Details panel. You can make changes from the panel and see all details about the feature.
- Planning Issues: An explanation of why a feature is highlighted in a certain color so that you can identify the issue and take action quickly.
- Feature Target Completion Sprints: This sprint selection is set on the feature’s Details panel.
- Target Completion Sprint: Defines when work will finish on your roadmap; it will not impact your work planned on the program board.
- Team Target Completion Sprints: A list of sprints into which a feature may be scheduled. The list is filtered for the selected PI and program. Select the sprint into which you want to schedule the feature. Once a team target completion sprint has been selected, the feature will move to the column on the board for that sprint.
- Details: Click Here: A link that displays the Work Item Details dialog box, which contains scheduling info for the feature:
- Use the drop-down menus in the dialog box to set the sprints that you plan to start and finish work on the feature.
- To unschedule the feature, choose Select One from both the Begin Work and the Finish Work drop-downs. You can select any of these items to view detailed information about them.
- The dialog box also shows any PIs in which the feature is scheduled for deployment and its current member weeks estimate.
- A change history shows who made changes to the feature’s scheduling information and when.
-
Stories: Displays stories associated with the feature. Stories that are not highlighted in blue are not assigned to a sprint. Additional fields in this section:
- ID: The unique identifier for the story. The ID is a clickable link that opens the story's Details panel.
- Title: The title of a story, risk, or dependency.
-
Sprint: The sprint in which the item is currently scheduled for implementation. If the name of the sprint is red, then there is a scheduling conflict regarding the item’s scheduling and its parent feature. For example, a feature is due in Sprint 1 but the stories will be done in Sprint 2. When a child story of a feature or a dependency of a feature is scheduled and conflicts with the scheduled sprint for the feature’s completion, the feature shows as a red rectangle. To resolve this conflict, you need to select a Target Sprint that is either the same as the latest scheduled story or dependency or one beyond.
You can also see which exact team missed their work on the feature. If a team did not finish all stories it was assigned to for a feature, and some stories are scheduled for completion past the due date of the feature, the feature shows as a red rectangle on that team’s row of the program board. For other teams which finished all stories for this feature or are in progress, the feature shows as green or blue correspondingly. - Team assigned/Risk resolution method: The short name of the team assigned to implement the item. For risks, the risk resolution method appears: R (Resolved), O (Owned), A (Accepted), or M (Mitigated).
- Status: Shows the status of a story, risk, or dependency.
-
Dependency and Risks sections: When present, stories, dependencies, and risks that are associated with the feature will display in their corresponding section. Additional fields are available for these items:
- ID: The unique identifier for the story, dependency, or risk. The ID is a clickable link that opens the Details panel of the work item.
- Title: Shows the title of a story, risk, or dependency. The stories that are not highlighted in blue are not assigned to a sprint.
-
Sprint: The sprint in which the item is currently scheduled for implementation. If the name of the sprint is red, then there is a scheduling conflict regarding the item’s scheduling and its parent feature. For example, a feature is due in Sprint 1 but the stories will be done in Sprint 2. When a child story of a feature or a dependency of a feature is scheduled and conflicts with the scheduled sprint for the feature’s completion, the feature shows as a red rectangle. To resolve this conflict, you need to select a Target Sprint that is either the same as the latest scheduled story or dependency or one beyond.
You can also see which exact team missed their work on the feature. If a team did not finish all stories it was assigned to for a feature, and some stories are scheduled for completion past the due date of the feature, the feature shows as a red rectangle on that team’s row of the Program Board. For other teams which finished all stories for this feature or are in progress, the feature shows as green or blue correspondingly. - Team assigned/Risk resolution method: The short name of the team assigned to implement the item. For risks, the risk resolution method appears: R (Resolved), O (Owned), A (Accepted), or M (Mitigated).
- Status: Shows the status of a story, risk, or dependency.
Notes: Being able to slot a sprint on the Feature Details panel on the program board is tied to being a Team of Team member on the corresponding Program Team.
Dependency Quick View fields
The following fields are available in the Quick View panel for dependencies:
- Dependency ID and name: A clickable link that opens the Details panel. You can make changes from the panel and see all details about the dependency.
- Planning Issues: An explanation of why a dependency is highlighted in a certain color so that you can identify the issue and take action quickly.
- Done: The status of whether work on the dependency is complete (set in the Work is Done drop-down on the dependency).
- Committed: The status of whether the dependency has been committed to a sprint.
- Depends: The teams associated with the dependency. If the dependency is cross-program, the programs of both teams are also listed here in the format [Requesting Team][Requesting Team’s Program] depends on [Depends On Team][Depends on Team’s Program].
- Program: The name of the requesting team’s program.
- Feature: The ID and name of the feature associated with the dependency.
-
Stories: Displays stories associated with the dependency. Stories that are not highlighted in blue are not assigned to a sprint. Additional fields in this section:
- ID: The unique identifier for the story. The ID is a clickable link that opens the story's Details panel.
- Title: The title of the story.
- Target Completion: The sprint in which the story is currently scheduled for implementation. If the name of the sprint is red, then there is a scheduling conflict regarding the item’s scheduling and its parent feature.
- Team: The short name of the team assigned to implement the story.
- State: Shows the state of a story.
Objective Quick View fields
The following fields are available in the Quick View panel for objectives:
- Objective ID and name: A clickable link that opens the Details panel. You can make changes from the panel and see all details about the objective.
- Planning Issues: An explanation of why a objective is highlighted in a certain color so that you can identify the issue and take action quickly.
- Type: The level selected in the Tier field of the objective, such as portfolio or program.
- Business Value: The value selected in the Planned Value field of the objective.
- Done: Displays as Yes when the Status field of the objective is set to Done.
-
Features: Displays features associated with the objective. Additional fields in this section:
- ID: The unique identifier for the feature. The ID is a clickable link that opens the feature's Details panel.
- Title: The title of the feature.
- Type: The type of feature; Business, Enabler, etc.
- Status: Shows the status of the feature.
-
Dependencies: Displays dependencies associated with the objective. Additional fields in this section:
- ID: The unique identifier for the dependency. The ID is a clickable link that opens the dependency's Details panel.
- Title: The title of the dependency.
- Needed By: The sprint selected in the Needed By dropdown on the dependency's Details panel.
-
Status: Displays the status of the dependency, depending on the agreement between requesting and delivering teams, and fields within the dependency:
- Not Committed: Displays when the dependency has not been committed to by the team it depends on.
- Comitted: Displays when the dependency has been committed to by the team it depends on.
- Delivered: Displays when the dependency's Work is Done field is set to Yes.
- No Work Required: Displays when the dependency's No Work Req field is set to Yes while the Work is Done field is set to No.
- Committed By: The sprint selected in the Committed By dropdown on the dependency's Details panel.
-
Risks: Displays risks associated with the objective. Additional fields in this section:
- ID: The unique identifier for the risk. The ID is a clickable link that opens the risk's Details panel.
- Title: The title of the risk.
- Owner: Displays the profile icon of the user selected in the risk's Owner field. Hover over the image to see the user's name.
- ROAM: Displays the selection made in the ROAM section of the risk's Details panel — Resolved, Owned, Accepted, or Mitigated.
- Status: Displays the status of the risk.
Join the Atlassian Community!
The Atlassian Community is a unique, highly collaborative space where customers and Atlassians come together. Ask questions and get answers, start discussions, and collaborate with thousands of other Jira Align customers. Visit the Jira Align Community Collection today.
Need to contact Jira Align Support? Please open a support request.