A plugin stopped working
Athanor runs every plugin in a sealed sandbox, so a plugin that fails cannot harm your document. The notice names the plugin and what went wrong. A plugin that fails three times in ten minutes is turned off for the session; press Turn back on in the notice, or reload Athanor.
Every plugin runs in its own sandbox with a time limit and a memory limit. When it breaks the rules or crashes, Athanor stops it and tells you in a notice at the bottom of the window. Your work is safe: a plugin can only change your document through Athanor, and only with permission.
A plugin stopped while running
| The notice says | What happened | What to do |
|---|---|---|
| "{Plugin} stopped responding. Your work is safe." | It ran longer than allowed in one go: 5 seconds for a community plugin, 15 for an official one. | Try again with a smaller selection or document. If it keeps happening, report it to the author. |
| "{Plugin} used too much memory. Your work is safe." | It went past its memory limit: 64 MB for a community plugin, 256 MB for an official one. | Same as above. |
| "{Plugin} hit an error: …" | The plugin's own code failed. The rest of the line is its first error message. | Try again. If it repeats, report it to the author with that message. |
| "{Plugin} was turned off because it kept failing. Your work is safe." | It failed three times within ten minutes. | Press Turn back on in the notice, or reload Athanor. It stays off for this session otherwise. |
| "{Plugin} is turned off for this session." | You used it after it was turned off for failing. | Turn it back on as above. |
| "{Plugin} returned no file." | An export or format plugin finished without producing a file. | Report it to the author. Export with a built-in format meanwhile. |
A plugin window that was stopped says why when you open it again: "It kept failing, so it was turned off for this session."
A plugin says it does not have permission
"{Plugin} does not have permission to read the document." or "… to edit the document."
The plugin asked to do something it did not declare when you installed it. Athanor refuses rather than asking you again, because a plugin may only do what its listing says. Nothing in your document changed. Check what it is allowed under Permissions; if it truly needs more, the author has to publish a version that asks for it.
A plugin will not install
| The message | What to do |
|---|---|
| "Sign in to install community plugins. They live on your account." | Sign in. Official plugins work without an account. |
| "Plugins are off. Turn them on in Settings to install and run plugins." | Plugins were switched off. Press Ctrl+K, type Plugins, and choose the Plugins switch to turn them back on, then install again. |
| "The plugin could not be downloaded. Check your connection and try again." | Check your connection and press Install again. |
| "The download did not match the published plugin, so it was not installed." | The file changed on the way. Try again; if it repeats, report the plugin. |
| "This version is not signed by Athanor, so it was not installed." | Only reviewed, signed versions install. Wait for the author's next approved version. |
| "This plugin has no approved version to install." | It has not passed review yet. |
| "The plugin package could not be read." | The package is damaged. Report the plugin. |
| "The plugin directory could not be reached. The official plugins are listed." | The directory is offline or your connection is down. The official plugins still install. |
To report a plugin, open it in the Plugins window and choose Report plugin. You see "Reported. A moderator will look at it."
Still stuck
- Turn the plugin off and on again under Turn off and uninstall.
- Uninstall and reinstall it. Uninstalling deletes its settings and saved data on your account; data it stored inside your documents stays in those files.
- Building your own plugin? The full error, with its stack, is in the plugin's console. The notice shows only the first line.
Is this helpful?
Last updated Nov 12, 2026
- Still stuck? Read the FAQ or contact support.
- Something wrong on this page? Tell us.
- For AI tools: llms.txt
