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

# License Count and Warnings

> Diagnose and resolve Nextedy PLANNINGBOARD license status messages, understand which features are restricted for unlicensed users, and confirm your license is correctly applied.

***

## Check the License Status

Navigate to **Administration > Nextedy PLANNINGBOARD** in your Polarion instance to open the license view. The page shows a color-coded status panel and the full license details (the signature field is automatically redacted for security — the license is still validated server-side).

The license view reports one of three states:

| Status    | Meaning                                                                           |
| --------- | --------------------------------------------------------------------------------- |
| Valid     | License is installed and verified. All editing features are available.            |
| `INFO`    | No production license detected — Planningboard is running in evaluation mode.     |
| `INVALID` | A license file is present but failed validation (expired, wrong host, corrupted). |

***

## Evaluation Mode

If no production license is installed, Planningboard runs for **30 days in evaluation mode**. The license view displays a notice and provides links to the installation guide and the pricing page.

<Warning title="Evaluation mode ends after 30 days">
  After the evaluation period expires, the board becomes read-only for all users until a valid production license is applied. Install the license before the 30-day window closes to avoid disruption.
</Warning>

***

## What Unlicensed Users Can and Cannot Do

License enforcement is per-user, not per-instance. A user without a Planningboard license assigned to their account can view the board but cannot modify it.

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/zUlmOSLBIQ0HyaAX/planningboard/diagrams/guides/troubleshooting/license-issues/diagram-1.svg?fit=max&auto=format&n=zUlmOSLBIQ0HyaAX&q=85&s=df3a4c715de5f47349d0587318cd3281" alt="Comparison table of board access by license status: unlicensed users can view board content, swimlanes, and calendar/Plan columns but cannot drag cards, create Plans, show unplanned items, or use sidebar editing tools, all of which licensed users can do" width="680" height="300" data-path="planningboard/diagrams/guides/troubleshooting/license-issues/diagram-1.svg" />
</Frame>

<Note title="Visibility is preserved for unlicensed users">
  Unlicensed users retain full read access to all board content — cards, swimlanes, capacity bars, and calendar columns are all visible. This supports transparency for stakeholders who do not need editing rights.
</Note>

***

## Resolve an INVALID License Status

If the status panel shows `INVALID`, work through these checks:

**1. Confirm the license file is in the correct location.**

The license file must be placed inside the Planningboard plugin folder on the Polarion server before startup. Refer to the [License Installation](/planningboard/getting-started/licensing) guide for the exact path.

**2. Restart Polarion after placing the license.**

The license is read at startup. If you dropped the file into the folder while Polarion was running, the status will remain `INVALID` until the server restarts.

**3. Verify the license was issued for this server.**

Licenses are host-bound. If you copied a license from a staging or evaluation environment to production (or vice versa), it will fail validation. Contact Nextedy support to request a license reissue for the correct host.

**4. Check for file corruption.**

Open the license file in a text editor. It should be a plain-text block with recognizable fields (licensee, product, expiry, etc.) and a signature block at the end. If the file is binary, empty, or truncated, it was likely corrupted during transfer — request a fresh copy.

<Warning title="Do not modify the license file">
  Editing any character in the license file — including whitespace or line endings — invalidates the cryptographic signature and causes an `INVALID` status. Always transfer license files as binary (not text) when using FTP or SCP.
</Warning>

***

## Resolve Read-Only Behavior for a Specific User

If a specific user reports that they can view the board but cannot drag cards, create Plans, or see the sidebar, their Planningboard license seat has not been assigned.

**Steps to resolve:**

1. Go to **Administration > Nextedy PLANNINGBOARD** and open the license details panel.
2. Confirm the license includes enough seats for the user in question. The license details block lists the maximum user count.
3. Assign the user a Planningboard license seat through your Polarion user management. The exact menu path depends on your Polarion version — refer to Siemens Polarion ALM documentation for license seat assignment.
4. Have the user reload the board page (use the **Refresh** button or browser reload). License state is checked at board load time.

<Tip title="Refresh resolves stale license state">
  If a user was recently assigned a license but the board still shows read-only behavior, clicking the **Refresh** button (the reload icon on the board toolbar) reloads the current state from the server and re-evaluates license status without a full page reload.
</Tip>

***

## Transition from Evaluation to Production License

When you receive a production license from Nextedy:

1. Stop the Polarion server.
2. Replace the evaluation license file (if any) in the plugin folder with the new production license file.
3. Start the Polarion server.
4. Navigate to **Administration > Nextedy PLANNINGBOARD** and confirm the status panel shows a valid (non-`INFO`) status.
5. Confirm the licensed user count in the displayed license details matches your purchased seats.

***

## Verification

After applying a license or assigning a seat, you should now see:

* The **Administration > Nextedy PLANNINGBOARD** license panel displays a green/valid status block (not `INFO` or `INVALID`).
* Licensed users see the **Create New Plan** button, the **Show Unplanned** button, and the sidebar panel on the board.
* Licensed users can drag cards between swimlanes and see their changes persist after a board refresh.
* The license details block in the administration view shows the correct licensee name, expiry date, and seat count.

***

## See Also

* [License Installation](/planningboard/getting-started/licensing) — step-by-step instructions for placing the license file
* [Common Errors](/planningboard/guides/troubleshooting/common-errors) — other board-level error messages and resolutions
* [Version Updates and Checking](/planningboard/guides/troubleshooting/version-updates) — confirm the installed plugin version matches the license version
* [Network and Firewall Requirements](/planningboard/guides/troubleshooting/network-requirements) — connectivity prerequisites that can cause boards to fail to load

<Accordion title="Sources">
  **Support Tickets**

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

  **Source Code**

  * `licenseReadonly.cy.ts`
  * `PlanningBoardWidgetRenderer.java`
  * `PlanningBoardWidgetDependenciesProcessor.java`
  * `PlanningBoardDataService.java`
  * `viewLicense.vm`
</Accordion>