Swimlane and Assignment Issues
Why are items jumping to a different swimlane after I drag them?
When using the Parent Item assignment type, the board enforces parent–child relationships. You can only place a task under its actual parent — if you drag it to a different swimlane, the board automatically moves it back to the correct parent row. This is by design: Planningboard maintains data integrity by keeping items linked to their real parent work item. To reassign a task to a different parent, update the parent link role in Polarion directly, then refresh the board.Why is the “Enumeration Field” swimlane assignment type showing an error about the field not being an enumeration?
The Enumeration Field assignment type requires that the selected field is a valid Polarion enumeration field (not a string or integer field). If you see a field validation error, verify that theField ID you entered references an actual enumeration custom field in your project. Global vs. project-specific field registration matters: fields defined only at project level may not resolve correctly in cross-project boards. After correcting the field ID, save the widget parameters and reload the page. If the error persists, rebuild the widget configuration from scratch.
Why do my swimlane assignments not support page parameters like $pageParameters.xxx?
Planningboard swimlane configuration does not support Polarion page parameters for dynamic team filtering. Widget parameter values are static — you cannot pass $pageParameters.team into the swimlane row configuration to switch teams dynamically. As a workaround, create a separate Planningboard page per team, each configured with the appropriate static swimlane settings. See Swimlanes for available swimlane assignment types and their constraints.
Why do swimlanes not appear for a custom Team work item type I created?
Planningboard does not support custom Team work item types for swimlane configuration. Only the standard Nextedy Team work item (with its specific custom fields) is recognized by the Teams Service integration. If your project uses a custom Team WI type, the unified Gantt + Planningboard solution using the standard Nextedy Team WI is the recommended path. Consult General for an overview of the supported planning model.Plans (Columns) Issues
Why do I not see any plan columns on the board?
The most common causes are: (1) the Plans Query does not match any plans in your project — check theplansQuery field syntax and verify plans exist with a matching Lucene query; (2) the Plans Type (plansMode) does not match your project structure — Project Plans (PROJECT_PLANS) works for standard Polarion projects, while SAFe modes require the Polarion SAFe Solution to be active; or (3) the lastPlans and nextPlans counts are both set to 0. Try setting Show # of last plans to 1 and Show # of next plans to 5 (the default).
Why does the configuration panel look different when I switch Plans Type?
The widget parameter panel changes dynamically based on your Plans Type selection. Project Plans (PROJECT_PLANS) shows the full set of fields including Scope, Query, Type, and the Sync to Parent option. SAFe modes such as SAFe Sprints in Program (SAFE_SPRINTS) and SAFe Sprints in Portfolio (SAFE_PFL_SPRINTS) show different fields — notably the Program Increment Parameter ID field, and the plan items section is hidden. This is expected behavior: different planning modes expose only the relevant configuration options.
SAFe plans type selection is highly context-dependent. Each hierarchy level (Portfolio, Program, Team) requires a distinct configuration. If plans are not appearing after switching to a SAFe mode, check that Page Parameters are explicitly created and referenced in the Program Increment Parameter ID field. See SAFe Integration for level-specific guidance.
Capacity Issues
Why is a user showing 0.0 total capacity even though they are assigned to tasks?
totalCapacity is sourced from the team calendar — if a user has no calendar entry or is not a member of the configured team in the Teams Service, their total capacity defaults to 0.0. Allocated capacity (sum of remaining estimates for their tasks) is calculated independently, so you may see a non-zero allocated value alongside zero total capacity. Verify that the user appears in the team calendar for the plan period, and that useTeamsService is enabled and selectedTeam points to the correct team.
Why is capacity not displaying at all on the board?
Capacity bars are only shown when Show Capacity Load (capacityLoad) is enabled in the widget parameters. If capacity still does not appear after enabling it, check that a valid capacityField is set (or that work items have remainingEstimate / initialEstimate values populated), and that hoursPerDay is configured correctly for your team’s working schedule. The Parent Item assignment mode (PARENT) does not support plan normalization (planCellsMode) — capacity display in that mode may be limited.
Access and Licensing Issues
Why can users view the board but not drag cards or access the sidebar?
Planningboard enforces license-based access control. Unlicensed users can view all board content — calendar data, swimlanes, and cards — but editing capabilities are restricted: drag-and-drop is blocked (cards return to their original position), the sidebar panel is hidden, and the Create New Plan and Show Unplanned buttons are not visible. This read-only mode is intentional for stakeholder visibility. To enable editing for a user, assign them a Planningboard license. See Licensing for license installation steps.Why is the “Create New Plan” button not visible in the toolbar?
The Create New Plan button (+ in the toolbar) is only visible to licensed users. If you have a license but still cannot see the button, verify that the New Plan section is enabled and configured in the widget parameters — Template ID must be set to a valid Polarion plan template (e.g., iteration or release). Without a Template ID, the new plan feature is inactive even for licensed users.
Board Refresh and Data Issues
Why is the board not reflecting recent changes made in Polarion?
The board renders from a server-side snapshot embedded at page load. After changes to plans, work items, or assignments in Polarion (or another board session), use the Refresh button (#btnRefresh) in the toolbar to reload the current state from the server. If changes made through drag-and-drop do not persist after refresh, check that the user has an active Planningboard license and that the Polarion session has write permissions to the affected plans and work items.
Quick Diagnostic Decision Tree
