Skip to main content

​
Prerequisites

  • You have a Planningboard widget configured on a Polarion page.
  • You are logged in with a licensed Planningboard user account.
  • You know which swimlane and Plan column you are trying to move cards between.

​
Symptom Checklist

Use the table below to jump to the relevant fix.

​
Cards Snap Back — Unlicensed User

If a card appears to drag normally but returns to its original position when you release it, the most likely cause is that your account does not hold a Planningboard license. How Planningboard enforces this: Unlicensed users can view the full board (all swimlanes, cards, and capacity bars are visible), but editing operations — including drag-and-drop, unplanning items, and creating new Plans — are blocked. Changes are not persisted. To verify:
  1. Look at the toolbar. If the Show Unplanned button and the Create New Plan button are both absent, your account is unlicensed.
  2. Ask your Polarion administrator to assign you a Planningboard license.
  3. After the license is applied, reload the page and retry the drag.
An unlicensed user sees the same board content as a licensed user. The only difference is that no edit operation — including drag-and-drop — is persisted. If drag-and-drop silently fails, always check the license before investigating configuration.

​
Drag-and-Drop Broken After Upgrade — Special Characters in Scripts

Planningboard versions before 25.2.0 contained a bug where drag-and-drop failed completely when any board script (item script, config script, or data script) included special characters (for example, accented letters, ampersands, or non-ASCII punctuation). Fix: Upgrade to Planningboard version 25.2.0 or later. This bug was resolved in the February 17, 2025 release. To check your version: Go to Administration > Nextedy PLANNINGBOARD and read the installed version number. If it is earlier than 25.2.0 and your scripts contain special characters, upgrade first before investigating other drag-and-drop issues.
If drag-and-drop worked before and stopped after adding a new script or editing an existing one, check whether the change introduced special characters. Upgrading to v25.2.0+ removes the underlying cause entirely.

​
Verified Work Items Cannot Be Dragged

Work items with a Verified status are intentionally locked. Once a card reaches the Verified state it cannot be dragged to a different Plan or swimlane, and the unplan action (the quick-action icon that returns a card to the Unplanned section) is also disabled for it. This is expected product behavior — it prevents accidental re-planning of completed work. If you need to move a Verified item:
  1. Open the work item in Polarion and change its status to a non-Verified state.
  2. Return to the Planningboard and refresh the board using the Refresh data button in the toolbar.
  3. The card is now draggable.

​
Multi-Valued Field Swimlanes — Unassigned Row

When the board uses a multi-valued field (for example, a multi-user assignee field or a multi-enum field) as the swimlane assignment type, the same work item can appear in multiple swimlane rows — one row per value. Dragging a card from one of these rows to the Not Assigned/Other swimlane removes only that specific value from the field, not all values. Example: A work item assigned to both Alice and Bob appears in both the Alice swimlane and the Bob swimlane. Dragging it from the Alice swimlane to Not Assigned/Other removes Alice from the assignees list, leaving Bob. The card then disappears from the Alice row but remains in the Bob row.
Dropping a card onto the Not Assigned/Other row is a field-value removal operation. It does not simply reposition the card — it modifies the work item’s field in Polarion. This change persists after board refresh. If you dropped a card on Not Assigned/Other unintentionally, undo it by adding the value back through the work item properties sidebar or directly in Polarion.
To confirm the change persisted: Click the Refresh data button in the toolbar after the drag. If the card no longer appears in the row you dragged from, the field was updated correctly.

​
Board Is Unresponsive or Loading Indefinitely

Infinite loading on the board (the spinner never resolves) is most often caused by a firewall or proxy blocking the network requests the board makes to the Polarion server — not a drag-and-drop configuration issue. However, it prevents any interaction, including dragging. Diagnostic steps:
  1. Open your browser’s developer tools (press F12) and go to the Network tab.
  2. Reload the board page.
  3. Look for requests that are blocked, timing out, or returning non-200 responses.
  4. If requests to your Polarion server domain are failing, contact your IT/network team to allow them through any corporate firewall or proxy.
For detailed network prerequisites, see Network and Firewall Requirements.

​
General Troubleshooting Flow

​
Verification

After applying the relevant fix above, confirm drag-and-drop is working:
  1. Open the Planningboard page in Polarion.
  2. Drag any unlocked card from the Unplanned section (or from one Plan column) to a different Plan column or swimlane row.
  3. Release the card. It should remain in the new position.
  4. Click the Refresh data button in the toolbar.
  5. You should now see the card still in its new position after the refresh, confirming that the change was persisted to Polarion.

​
See Also

KB Articles
  • Planningboard interface & basic interactions
  • Troubleshooting Script Errors in Planningboard
Support TicketsSource Code
  • licenseReadonly.cy.ts
  • PlanningBoardWidgetDependenciesProcessor.java
  • PlanningBoardWidget.java
  • displayingMultiEvents.cy.ts
  • PlanningBoardDataService.java
Last modified on July 10, 2026