Before you start
- The Planningboard widget is embedded and configured on a Polarion LiveDoc or Wiki page.
- Plans are already set up as columns and swimlanes are configured. See Configure Plans (Columns) and Configure Swimlanes (Rows) if needed.
- You have write access to the work items you want to plan.
Board layout at a glance
1
Open the Unplanned section
If the Unplanned section is not visible, click the Show Unplanned button in the toolbar (the panel icon). The section slides open on the right side of the board.
2
Locate the card to plan
Scroll or filter the Unplanned section to find the work item you want to assign. Each card in the Unplanned section represents a single Polarion work item.
3
Drag the card onto the board
Click and hold the card, then drag it into the target cell — the intersection of the Plan column and swimlane row where you want to schedule it.A visual highlight marks the drop target as you drag over valid cells. Release the card to confirm the assignment.What happens when you drop a card:
- The work item is added to the Plan that corresponds to the column. Internally, Planningboard assigns the item based on the Plan’s date range (
start_date/end_date). - If swimlanes are set to Users (Assignee) mode, dropping into a swimlane also reassigns the work item to that user.
- If swimlanes use an Enumeration Field mode (for example, a team or component field), dropping into a swimlane updates that enumeration field on the work item.
- If Assign to Parent Plan is enabled in the widget parameters, the work item is also planned into the parent Plan of the target column automatically.
4
Move cards between cells
You can also drag cards already on the board:
- Between columns — reschedules the work item into a different Plan.
- Between swimlanes — reassigns the work item to a different resource or changes its enum field value, depending on the swimlane assignment type.
- Back to the Unplanned section — hover over the card to reveal the Unplan item quick action (the arrow icon in the upper-right corner of the card), then click it. This removes the item from its current Plan.
5
Monitor capacity as you plan
After dropping cards, watch the capacity bar at the top of each column or swimlane (if capacity display is enabled). The bar shows how much capacity has been consumed relative to the Plan’s total.If capacity bars are not visible, see Configure Capacity Tracking.
6
Verify the assignment
After dropping, the card appears in the target cell. The board preserves your swimlane position and scroll location — it does not jump back to the top, so you can keep planning without losing your place.Click the card to open the Work Item Properties sidebar and confirm the Plan assignment and assignee fields are set as expected.You should now see the card in the correct Plan column and swimlane row, the capacity bar updated to reflect the new load, and the work item removed from the Unplanned section.