> Updated for version 6.0.30

When something goes wrong, Celestory shows a message that says what happened and what to do, and lets you copy the technical details to send to support. This article explains how to read it and what to do about the most common errors.

![Explained error: red box with title, explanation, solution and Copy for support button, then the same message in a red toast](https://chatwoot.fr.nocodespacelab.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBdGNKIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--532a98b5dd5b88d234edf40225b8063f67f1cb6c/petits-divers--erreur-expliquee-notice.en.png)
*a red error notification with its title, explanation, solution and the Copy for support button*

## What an explained error looks like

The message appears in a notification (it stays about 15 seconds, and pauses while the mouse is over it) or in a red box inside the window concerned, for example the variables import or the PDF export. It contains:

- a **title** that names the problem, for example "Storage full";
- an **explanation**: what happened, in plain words;
- a **solution**: what you can do;
- sometimes one or more **action buttons**;
- the **Copy for support** button.

When the title only says what failed ("The project was not saved", "Publishing failed"), the cause is a general problem (connection, server, timeout). Read the explanation just below.

## Action buttons

Depending on the error, and only if the screen where it happens can handle it, you may see:

| Button | When |
|---|---|
| **Sign in again** | Your session has expired. |
| **See my plan** | A quota, limit or trial has been reached. |
| **Reload the page** | The view needs refreshing. |
| **Change model** | The chosen AI model does not suit the request. |
| **Remove the attachment** | A file attached to an AI conversation causes a problem. |
| **Choose how to read it** | A scanned PDF has to be read another way. |
| **Send an excerpt** | A document is too long for the model. |
| **Turn off web search** | The model does not offer web search. |
| **New conversation** | The AI conversation is too long or cannot be found. |

## Copy for support

1. Click **Copy for support**;
2. wait for the **Details copied** message;
3. paste the text into your message to support, with a sentence about what you were doing.

If the clipboard refuses the copy, the message **The details could not be copied automatically** appears: write down the error title and the time instead.

The copied text starts with "Celestory support details". It holds the error code, the date, the action in progress, the server status and the request id when there is one, the project id and your account id, the Celestory version and the technical message. Passwords, tokens, e-mail addresses and web address parameters are removed, and a file name is hidden. The technical message is limited to 500 characters.

> 💡 **Tip:** copy the details before reloading the page, and do not edit them: the code and the time let support find your error.

## The most common errors

| Message | What it means | What to do |
|---|---|---|
| Cannot connect | Celestory could not reach its servers. | Check your connection, then try again. |
| Took too long | The server took too long to answer. | Try again in a moment. |
| A problem on our side | The server ran into an error. | Try again; if it keeps happening, copy the details for support. |
| Part of Celestory could not load | Connection dropped, or a new version was released. | Try again; otherwise save your project, then reload the page. |
| Too many requests | Many requests in a short time. | Wait a minute. |
| Request not processed | The server could not process the request. | Reload the page and try again. |
| An unexpected error occurred | Unforeseen case. | Try again, then copy the details. |
| File too large | The file is over the accepted size. | Shrink or compress the file. |
| File not found | The file no longer exists in the project. | Reload the page. |
| Storage temporarily unavailable | The file service did not answer. | Try again in a moment. |
| Project not found | It does not exist any more, or is not shared with you. | Reopen it from your project list. |
| Action not allowed | Your account lacks the rights. | Ask the owner for access, or check your account. |

## Plan, quotas and storage

| Message | What to do |
|---|---|
| AI quota reached | Wait for next month, or upgrade your plan. |
| Storage full | Delete files you no longer need, or upgrade your plan. |
| Project limit reached | Archive or delete a project, or change plan. |
| Too many people invited | Remove someone from the project, or change plan. |
| Free trial over | Pick a plan. |
| Plan required | Upgrade to the plan shown to open the project. |

## Export and publishing

| Message | What to do |
|---|---|
| Publishing failed | Try again; if it keeps happening, copy the details. |
| The book is empty | Add Story, Dialogue or Choice blocks to the module, or pick another starting module. |
| The PDF font could not be downloaded | The book has characters beyond the basic Latin alphabet: check your connection, then try again. |
| The PDF was not created | Try again; if it keeps happening, copy the details. |
| The variables were not imported | See [Importing and exporting variables as JSON](https://documentation.celestory.io/hc/celestorydoc/articles/1795347829-importing-and-exporting-variables-as-json). |

## Signing in and your account

| Message | What to do |
|---|---|
| Your session has expired | Click **Sign in again**, then retry. |
| Wrong e-mail or password | Check what you typed, or reset your password. |
| E-mail address not confirmed | Open the confirmation e-mail, and check your spam folder too. |
| E-mail address already in use | Sign in with that account, or use another address. |

Two-factor authentication errors have their own messages: see [Protect your account with two-factor authentication](https://documentation.celestory.io/hc/celestorydoc/articles/1795347758-protect-your-account-with-two_factor-authentication).

## AI errors

| Message | What to do |
|---|---|
| AI service unavailable, AI service overloaded | Wait a few minutes, then try again. |
| The AI took too long to answer | Try again with a shorter request or a lower reasoning level. |
| Conversation too long for this model | Start a new conversation, or remove some attachments. |
| This model cannot use tools | Choose a model that supports them (Celestory never changes model for you). |

## When to contact support

Contact support if the same message keeps coming back after several tries, especially "A problem on our side" or "An unexpected error occurred". Attach the text copied with **Copy for support**.

## See also

- [When nothing works, and nothing says why](https://documentation.celestory.io/hc/celestorydoc/articles/fr-decouvrir-celestory-quand-rien-ne-marche-et-que-rien-ne-le-dit-173cef)
- [Importing and exporting variables as JSON](https://documentation.celestory.io/hc/celestorydoc/articles/1795347829-importing-and-exporting-variables-as-json)
- [Protect your account with two-factor authentication](https://documentation.celestory.io/hc/celestorydoc/articles/1795347758-protect-your-account-with-two_factor-authentication)
