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

> Diagnose and resolve Nextedy RISKSHEET license issues including read-only access, missing named users, and license page discrepancies.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

## License Validation Quick Reference

Use the following decision table to identify your specific issue and jump to the appropriate section:

| Symptom                                              | Likely Cause                 | Section                                                                         |
| ---------------------------------------------------- | ---------------------------- | ------------------------------------------------------------------------------- |
| Sheet is read-only for all users                     | No named users configured    | [Named Users Show as Zero](#named-users-show-as-zero)                           |
| "You have read-only access only. (Reviewer License)" | User not in license group    | [Reviewer License Message](#reviewer-license-message)                           |
| License page shows 0 named users after upgrade       | Group alignment needed       | [Post-Upgrade License Alignment](#post-upgrade-license-alignment)               |
| Server user count higher than expected               | All registered users counted | [Server User Count Discrepancy](#server-user-count-discrepancy)                 |
| License page is empty                                | Plugin cache not cleared     | [Empty License Page](#empty-license-page)                                       |
| License status shows inactive after group changes    | Service restart required     | [License Not Recognizing Group Changes](#license-not-recognizing-group-changes) |

## Server User Count Discrepancy

### Problem

The license page reports a much higher server user count than the number of active Polarion license holders. For example, you have 50 Polarion ALM licenses but the Risksheet license page shows 203 server users.

### Cause

Risksheet counts **all registered users on the Polarion server** as server users, regardless of their Polarion license type. This includes:

* Users with active ALM, QA, or ITAR licenses
* Users with expired or deactivated Polarion licenses
* Service accounts and integration users
* Users who were once active but no longer use the system

This count is independent of how many Polarion licenses are assigned.

### Resolution

You have two options:

**Option A: Clean up inactive server users**

1. Navigate to **Administration > User Management** in Polarion
2. Identify users who no longer need access to the system
3. Remove or deactivate unused accounts
4. Return to the Risksheet license page and verify the reduced server user count

**Option B: Upgrade your Risksheet license**

If cleaning up users is not practical, upgrade to a license tier that accommodates your total server user count. Contact Nextedy sales for license tier options.

<Warning title="SMB Discount Threshold">
  The SMB (Small and Medium Business) discount for Risksheet licenses requires staying within 50 server users. If your Polarion server exceeds 50 registered users, the SMB pricing tier is not available regardless of how many active Polarion licenses you hold.
</Warning>

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/t34k0QhMnn4JCqkc/risksheet/diagrams/troubleshooting/license-validation-errors/diagram-1.svg?fit=max&auto=format&n=t34k0QhMnn4JCqkc&q=85&s=61127cd7f5a56c77fe6f5ae59f1c8882" alt="diagram" style={{ maxWidth: "560px", width: "100%" }} width="560" height="340" data-path="risksheet/diagrams/troubleshooting/license-validation-errors/diagram-1.svg" />
</Frame>

## Named Users Show as Zero

### Problem

The Risksheet license page displays 0 configured named users, even though you have created the `nextedy_risksheet_users` group and added users to it.

### Cause

This can occur for several reasons:

1. The user group name is misspelled (must be exactly `nextedy_risksheet_users`)
2. Users were added by username instead of email address
3. Polarion services have not been restarted since the group was created
4. The group exists but contains no members

### Resolution

**Step 1:** Verify the group name in **Administration > User Management > Groups**. The group name must be exactly `nextedy_risksheet_users` (case-sensitive, with underscores).

**Step 2:** Open the group and verify that user entries are present. Users should be identified by their Polarion user IDs.

**Step 3:** Restart Polarion services:

```text theme={null}
# Linux
systemctl restart polarion

# Windows
Restart the Polarion service via Services console
```

**Step 4:** After restart, navigate to **Administration > Nextedy Risksheet > License** and verify that the named user count reflects the group membership.

<Tip title="Restart Required After Group Changes">
  After creating or modifying the `nextedy_risksheet_users` group, a Polarion service restart may be required for the license to recognize the named users. Simply revisiting the license page without a restart may not trigger the update.
</Tip>

## Reviewer License Message

### Problem

Users see the error message:

```text theme={null}
You have read-only access only. (Reviewer License)
```

The Risksheet grid loads but all cells are non-editable. Save operations are blocked.

### Cause

This message appears when:

* The user is not a member of the `nextedy_risksheet_users` group (they receive Connect/read-only access)
* The `reviewer` property is set to `true` in the document's sheet configuration
* The license has expired or is in an invalid state

### Resolution

**If the user should have edit access:**

1. Navigate to **Administration > User Management > Groups**
2. Open the `nextedy_risksheet_users` group
3. Add the user's Polarion user ID to the group
4. Restart Polarion services if the change is not immediately reflected
5. Ask the user to refresh the Risksheet page

**If the user is a reviewer:**

The message is expected behavior for reviewers. Users with the reviewer role can view data and participate in review workflows but cannot modify risk item data. If this is not the intended behavior, check the `reviewer` property in the sheet configuration:

```yaml theme={null}
reviewer: false
```

Setting `reviewer` to `false` (or removing the property, as `false` is the default) restores standard editing capability for licensed users.

## Post-Upgrade License Alignment

### Problem

After upgrading Risksheet to version 25.11.0 or later, the license page shows 0 named users and all sheets are in read-only mode, even though the `nextedy_risksheet_users` group is correctly configured.

### Cause

Starting with version 25.11.0, when Powersheet is also installed on the server, the license system requires a `nextedy_powersheet_users` group for proper alignment. The old `nextedy_risksheet_users` group alone is no longer sufficient when Powersheet is present.

### Resolution

**Step 1:** Create a new Polarion user group named `nextedy_powersheet_users`

**Step 2:** Add all users from the `nextedy_risksheet_users` group to the new `nextedy_powersheet_users` group

**Step 3:** Restart Polarion services

**Step 4:** Verify the license page now shows the correct named user count

| Post-Upgrade Group Configuration                   |                                                    |                                                    |
| -------------------------------------------------- | -------------------------------------------------- | -------------------------------------------------- |
| nextedy\_risksheet\_users                          | nextedy\_powersheet\_users                         |                                                    |
| - [user\_a@company.com](mailto:user_a@company.com) | - [user\_a@company.com](mailto:user_a@company.com) |                                                    |
| - [user\_b@company.com](mailto:user_b@company.com) | -->                                                | - [user\_b@company.com](mailto:user_b@company.com) |
| - [user\_c@company.com](mailto:user_c@company.com) | - [user\_c@company.com](mailto:user_c@company.com) |                                                    |
| (Required for v25.11.0+                            |                                                    |                                                    |
| when Powersheet installed)                         |                                                    |                                                    |

<Warning title="Both Groups Required">
  Do not remove the `nextedy_risksheet_users` group when creating the `nextedy_powersheet_users` group. Both groups should exist and contain the same set of users. Removing the original group may cause additional license validation failures.
</Warning>

## Empty License Page

### Problem

The Risksheet License page in Polarion administration appears completely empty with no content, no fields, and no status information.

### Cause

The Polarion plugin cache directory (`[POLARION_INSTALL]/data/workspace/.config`) was not deleted after installing or updating Risksheet. This cached data prevents Polarion from loading the new administration pages.

### Resolution

**Step 1:** Stop the Polarion service

**Step 2:** Delete the configuration cache directory:

```text theme={null}
[POLARION_INSTALL]/data/workspace/.config
```

Delete the entire `.config` directory, not just its contents.

**Step 3:** Start the Polarion service

**Step 4:** Navigate to **Administration > Nextedy Risksheet > License** and verify the page now loads with license information

<Note title="This Applies to Updates Too">
  The `.config` directory must be deleted every time you install or update Risksheet. This is not only a first-time installation step. Forgetting to delete the cache after an update will cause the Setup and License pages to display stale or empty content.
</Note>

## License Not Recognizing Group Changes

### Problem

After adding users to the `nextedy_risksheet_users` group, the Risksheet license page still shows the old named user count. Users who were just added still see read-only access.

### Cause

License validation caches group membership data. Changes to user groups are not always immediately reflected without a service restart.

### Resolution

**Step 1:** Verify the group membership is correct in **Administration > User Management > Groups**

**Step 2:** Restart Polarion services to force license revalidation

**Step 3:** After restart, check the license page for updated counts

**Step 4:** Ask affected users to clear their browser cache and reload the Risksheet page

<Tip title="License Revalidation">
  Risksheet supports dynamic license revalidation. In most cases, license status changes (such as upgrading from evaluation to production, or adding a Powersheet license) are detected automatically without requiring a restart. However, changes to user group membership specifically may require a restart to take effect.
</Tip>

## Powersheet License Interaction

When Powersheet is installed alongside Risksheet, the licensing system manages both products through separate license managers. Key points to verify:

| Check                            | Expected                                                       |
| -------------------------------- | -------------------------------------------------------------- |
| Risksheet license status         | Active                                                         |
| Powersheet license status        | Active (if installed)                                          |
| `nextedy_risksheet_users` group  | Contains all edit users                                        |
| `nextedy_powersheet_users` group | Contains same users (v25.11.0+)                                |
| Evaluation vs. Production        | Evaluation Powersheet licenses do not unlock enhanced features |

When a valid Powersheet production license exists, Risksheet automatically unlocks additional features. This detection is automatic and requires no manual configuration. Evaluation or trial Powersheet licenses do not enable these enhancements.

## Verification

After resolving your license issue, you should now see:

* The license page displaying the correct server user count and named user count
* Licensed users able to edit cells and save changes in the Risksheet grid
* The `readonly` indicator absent from the status bar for named users
* Non-named users correctly receiving read-only (Connect) access

## See Also

* [Understand License Types](/risksheet/guides/licensing/understanding-licenses)
* [Choose License Tier](/risksheet/guides/licensing/license-tiers)
* [Assign Active Users](/risksheet/guides/licensing/assigning-active-users)
* [Manage User Groups](/risksheet/guides/licensing/user-groups)
* [Installation](/risksheet/getting-started/installation)
* [Access Denied Errors](/risksheet/troubleshooting/access-denied)
* [Permission-Based Field Restrictions](/risksheet/troubleshooting/permission-errors)

<LastReviewed date="2026-06-29" />
