Troubleshooting¶
No AI tab in the Media Library¶
Check, in this order:
- Offer the AI tabs is on, and the generator is ticked under Generators this site offers (settings).
- The generator has a Media type in the Generators table, and that type is allowed where the library opened: the field's Media types, or the text format's Embed media filter.
- The user has Generate media with AI and Create new media for that media type.
- The generator's operations have a provider. Editors do not see a tab that cannot work; users with Administer AI see it with a message.
An SVG does not show, or cannot be selected¶
See the table in SVG and animated SVG.
An animated SVG does not move¶
It moves only when printed inline: the Inline SVG (animated) display or
the Animated SVG component. In an <img> only animation inside the file
runs, and never on scroll. With reduced motion turned on, it is shown
finished on purpose.
"… generation is not set up"¶
An operation the generator calls has no AI module default. Set one on the AI
settings (/admin/config/ai/settings); see Providers.
"This media type does not accept the … files this generator makes"¶
Checked before anything is sent: the formats enabled for the generator are not among the field's Allowed file extensions. The Generators tab says which field refuses which format and links to it.
"This media type does not accept .… files"¶
The source field's Allowed file extensions lacks what the generator wrote. Add it, or for images choose an Image file format the field allows.
"The generated file is …, more than the … this site accepts"¶
The result is larger than the field's maximum upload size or the AI Media Maximum file size. Raise one, or ask for something smaller.
The tab is in the wrong place¶
With Right after the tab of their media type, an AI tab follows the tab of the media type its generator saves into. Choose After all the other tabs to keep them together at the end.
No Dictate button¶
The microphone is off by default, and a browser without Web Speech support (Firefox, for one) shows no button even when it is on.
Generation fails¶
Editors get one plain sentence that says what to do next; the description is
kept and focus returns to it. Users with Administer AI also see the
service's own message and where to fix it, and every failure is logged on the
ai_media channel (Reports > Recent log messages).
| Message | Cause | For administrators |
|---|---|---|
| "This site's AI rules stopped this request." | A guardrail set stopped it | The set, linked |
| "This description was flagged as unsafe and was not sent." | Moderation: the site's AI External Moderation rules or the provider's own | A link to the AI moderation settings |
| "The AI service could not use this description." | The provider refused the request | The provider's message |
| "Too many requests right now." | Rate limit (HTTP 429) | |
| "Generation is not available right now." | No credit, or the key is missing or refused (HTTP 401 or 403) | "Check the provider account's credit or plan." or "Check the API key." |
| "The AI service took too long." | The request timed out | The AI module's request timeout and where to change it |
| "This could not be made." | Anything else | The provider's message |