Visualize Capacity Load

​

Prerequisites

• The Teams Service is configured and your project has at least one team with members and a calendar. See Set Up Teams Service.
• Team members have remaining estimates on their assigned work items.
• You have access to edit the widget parameters on your Planningboard page.

​

How Capacity Is Calculated

availableCapacity = totalCapacity - allocatedCapacity

​

Capacity Visualization Modes

1

Enable Basic Capacity Bars (Column-Level)

Column-level capacity bars show the aggregate load across all users for each Plan column. This is the simplest mode and requires no Teams Service.

1. Open the Polarion page that contains your Planningboard widget.
2. Click Edit to enter page editing mode.
3. Open the widget parameters editor for your Planningboard widget.
4. Set the capacityLoad parameter to true.
5. Set the capacityField parameter if your team tracks effort in a custom field (for example, story points). Leave it blank to use Polarion’s built-in remainingEstimate / initialEstimate fields.
6. Set hoursPerDay to the number of working hours per day used in calculations (default: 8).
7. Save the page.

If your work items carry story points in a custom field (for example storyPoints), set capacityField = storyPoints. Planningboard will sum that field instead of time estimates. Combine with a matching hoursPerDay conversion only when mixing time-based and point-based effort.

2

Enable Per-User Capacity (Teams Service Mode)

Per-user capacity shows each team member’s individual allocation and remaining capacity in summary cells on the board. This mode requires the Teams Service and assignmentMode = ASSIGNEE.

1. Confirm that useTeamsService is set to true in your widget parameters.
2. Set selectedTeam to the ID of the team you want to display capacity for.
3. Set userCapacityLoad to true.
4. Save the page.

When configured, the board displays a summary cell per user row. Each summary cell shows:

• Allocated — sum of remaining estimates for tasks assigned to that user in the Plan
• Total — user’s total available hours from the team calendar
• Available — total minus allocated (shown in red if negative)

If a team member has no calendar entry in the Teams Service, their totalCapacity defaults to 0.0. Any assigned work immediately flags them as overallocated. Verify calendar coverage in the Teams Service before relying on per-user capacity numbers.

3

Enable Per-Swimlane Capacity (Multi-Capacity Mode)

Multi-capacity mode shows a capacity progress bar in each individual swimlane cell — useful when different resources have significantly different capacities.

1. Ensure capacityLoad is set to true — multiCapacityLoad takes effect only when capacityLoad is also enabled.
2. Set multiCapacityLoad to true in the widget parameters.
3. Ensure useTeamsService is true (multi-capacity reads per-resource capacity from the Teams Service data).
4. Save the page.

4

Customize the Capacity Tooltip

By default, capacity bars show a tooltip with aggregate Capacity / Done / Todo / Available values. You can customize this tooltip to show a per-user allocation breakdown using the columnTooltipTemplate parameter.Set columnTooltipTemplate to a template string or a JavaScript function that receives the column and row objects. When no custom template is configured, the default aggregate tooltip is used automatically.

A custom columnTooltipTemplate can highlight overallocated users in red. The format typically shows Available (Overallocated) / Allocated / Total per team member, making resource bottlenecks easy to spot during planning sessions.

​

Known Limitations

​

Verification

• Column-level mode (capacityLoad): A progress bar appears at the top of each Plan column, showing aggregate load as a percentage and total hours.
• Per-user mode (userCapacityLoad): Each assignee swimlane row has a summary cell showing allocated, total, and available hours. Overallocated users appear with a red indicator.
• Multi-capacity mode (multiCapacityLoad): Individual swimlane cells display their own progress bars.

​

See Also

• Configure Capacity Tracking — widget parameters for capacity configuration
• Track Team Capacity — set up team-level capacity tracking
• Track User Capacity — configure per-user capacity
• Normalize Capacity Across Swimlanes — equalize capacity when swimlanes differ in size
• Set Up Teams Service — prerequisite for per-user and multi-capacity modes
• Capacity Calculation Issues — troubleshoot missing or incorrect capacity values