> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Drag and Drop Issues

> Resolve the most common reasons why cards fail to move, snap back, or behave unexpectedly when dragging on the Nextedy PLANNINGBOARD.

***

## 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.

| Symptom                                                                         | Jump to                                                                                 |
| ------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
| Card moves but snaps back to its original swimlane                              | [Check your license](#cards-snap-back-unlicensed-user)                                  |
| All drag-and-drop stopped working after a recent upgrade                        | [Version 25.2.0 fix](#drag-and-drop-broken-after-upgrade-special-characters-in-scripts) |
| Card with **Verified** status cannot be moved or unplanned                      | [Verified items are locked](#verified-work-items-cannot-be-dragged)                     |
| Dragging a card to the Not Assigned/Other swimlane removes a value unexpectedly | [Multi-valued field behavior](#multi-valued-field-swimlanes-unassigned-row)             |
| Board is unresponsive or loading indefinitely                                   | [Network and firewall check](#board-is-unresponsive-or-loading-indefinitely)            |

***

## 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.

<Warning title="Visibility does not imply edit access">
  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.
</Warning>

***

## 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.

<Tip title="Upgrade is the fastest resolution">
  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.
</Tip>

***

## 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.

<Warning title="Not Assigned/Other removes, not moves">
  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.
</Warning>

**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](/planningboard/guides/troubleshooting/network-requirements).

***

## General Troubleshooting Flow

```text theme={null}
Card won't stay where I dropped it
        |
        v
  Is the user licensed?
  (Check toolbar: Show Unplanned visible?)
        |
    NO  |  YES
        |    |
        |    v
        |  Is the card's status "Verified"?
        |        |
        |    YES |  NO
        |        |   |
        |        |   v
        |        |  Is the board version < 25.2.0
        |        |  AND do any scripts contain
        |        |  special characters?
        |        |        |
        |        |    YES |  NO
        |        |        |   |
        |        |        |   v
        |        |        |  Is this a multi-valued
        |        |        |  field swimlane and was the
        |        |        |  target the UNASSIGNED row?
        |        |        |        |
        |        |        |    YES |  NO
        |        |        |        |   |
        v        v        v        v   v
    Assign   Change   Upgrade    This is   Check
    license  status   to 25.2.0  expected  network
             first               behavior  / console
```

***

## 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

* [Drag and Drop Planning](/planningboard/guides/planning/drag-and-drop) — how drag-and-drop assignment works for Plans and swimlanes
* [Basic Board Interactions](/planningboard/getting-started/basic-interactions) — toolbar controls, card quick actions, and the Unplanned section
* [Multi-Valued Field Swimlanes](/planningboard/guides/swimlanes/multi-valued-swimlanes) — how items appear in multiple rows and how dragging to Not Assigned/Other updates field values
* [License Count and Warnings](/planningboard/guides/troubleshooting/license-issues) — diagnosing license assignment problems
* [Network and Firewall Requirements](/planningboard/guides/troubleshooting/network-requirements) — prerequisites for the board to load and function
* [Swimlane Expansion Issues](/planningboard/guides/troubleshooting/swimlane-expansion) — related browser-specific interaction issues

<Accordion title="Sources">
  **KB Articles**

  * Planningboard interface & basic interactions
  * Troubleshooting Script Errors in Planningboard

  **Support Tickets**

  * [#6357](https://support.nextedy.com/helpdesk/tickets/6357)
  * [#6688](https://support.nextedy.com/helpdesk/tickets/6688)
  * [#6659](https://support.nextedy.com/helpdesk/tickets/6659)

  **Source Code**

  * `licenseReadonly.cy.ts`
  * `PlanningBoardWidgetDependenciesProcessor.java`
  * `PlanningBoardWidget.java`
  * `displayingMultiEvents.cy.ts`
  * `PlanningBoardDataService.java`
</Accordion>