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

# Troubleshooting

## Errors

All license errors are `ReductoLicenseError`. The message starts with `Reducto license <status>`, says what to do, and ends with ` [<code>]`. To find them in your code, check `error.name === "ReductoLicenseError"`.

Use `error.code` to select what to show. It is a stable string and does not change when the message text changes. The code is also at the end of the message. If only the message gets to your code (for example, from a worker), find the code with `/\[(REDUCTO_LICENSE_[A-Z]+)\]$/`. `error.status` has the status.

| Code | Status | Cause | What to do |
| - | - | - | - |
| `REDUCTO_LICENSE_UNCONFIGURED` | `unconfigured` | The message is "Your package isn't configured properly." The copy was not installed with a Studio install token, `REDUCTO_API_KEY` is missing or from a different organization, a browser editor has no license proxy, or the package cannot reach Reducto | Install with a Studio install token. Set `REDUCTO_API_KEY` from the organization that made the install token, on the server or the license proxy. See [Setup](https://docs.reducto.ai/office/licensing/setup.md) |
| `REDUCTO_LICENSE_REVOKED` | `revoked` | Reducto revoked your organization's license | Contact [support@reducto.ai](mailto:support@reducto.ai). A new install token does not help |
| `REDUCTO_LICENSE_EXPIRED` | `expired` | Your organization's license expired | Contact [support@reducto.ai](mailto:support@reducto.ai) |
| `REDUCTO_LICENSE_UNLICENSED` | `unlicensed` | Your installed copy has no license. The message is `Reducto license: this copy of @reductoai/docx has no license…` | Install `@reductoai/docx` again with your Studio install token |
| `REDUCTO_LICENSE_UNPAID` | `unpaid` | Your organization is out of Reducto credits | Add Reducto credits, or contact [support@reducto.ai](mailto:support@reducto.ai). The package starts to work again at its next check, in less than about one hour |
| `REDUCTO_LICENSE_UNKNOWN` | `unknown` | Reducto does not know the license in your installed copy | Install again with a current Studio install token |
| `REDUCTO_LICENSE_UNPROXIED` | `unproxied` | A browser editor has no license proxy. The message is `Reducto license: a browser must reach Reducto through your backend…` | Add the [license proxy](https://docs.reducto.ai/office/licensing/setup.md#3-in-a-browser-add-the-license-proxy) and set `proxyUrl` (or call `useProxy`) before you open a document |
| `REDUCTO_LICENSE_UNVERIFIED` | `unverified` | The package could not check its license: no good answer for more than 65 minutes since its last good check | Let your server (or, for a browser, your license proxy) reach Reducto over HTTPS. See [Firewalls](https://docs.reducto.ai/office/licensing/setup.md#firewalls-and-networks-with-no-internet-access). The package starts to work again after the next good check, usually in less than 5 minutes |
| `REDUCTO_LICENSE_UNDELIVERED` | `undelivered` | Reducto answers checks, but the usage report of a new Session did not reach it within 30 seconds | Let your server (or your license proxy) reach Reducto. The package starts to work again when a check confirms the report |

## Console warnings

The package shows each warning one time. If a page uses `@reductoai/docx` and `@reductoai/docx-editor`, you can see the same warning two times.

| Warning | Cause | What to do |
| - | - | - |
| `Reducto usage events rejected (401 …)` or `(403 …)` | Reducto does not know your license, or it is revoked | Do the steps for `unknown` or `revoked` above |
| `Reducto usage events rejected (4xx …)` with a different code | Reducto refused a usage report | Send the full message to [support@reducto.ai](mailto:support@reducto.ai) |

## Installs

| Problem | Cause | What to do |
| - | - | - |
| `npm install` gets `401` or `404` for `@reductoai/…` | A line is missing from `.npmrc`, or the token was revoked | Make sure that `.npmrc` has both lines. Make a new token |
| `npm install` gets `403` for `@reductoai/docx` | Your lockfile or `package.json` asks for a version that your token cannot install | Run `npm install @reductoai/docx` |
| You cannot make a token: `this org's license is revoked` | Your organization's license is revoked | Contact [support@reducto.ai](mailto:support@reducto.ai) |

## Network problems you do not need to fix

* **A failed usage report is sent again** later. A short network problem does not stop the package.
* **A short outage at Reducto** does not stop the package, because each good check lasts 65 minutes.
