AI Editor Actions

AI Editor Actions adds an "AI Actions" dropdown to CKEditor 5 that runs user-defined AI text transformations - rephrase, fix grammar, translate, summarize, change tone, and more - on the selected text or, with nothing selected, the whole document. Generation happens in place: the result replaces the text and is highlighted as a tracked change you can review, step through its history, flip back to the original, regenerate or keep.

The actions themselves are content, not code. Any editor with permission builds their own library of transformations right from the editor and, optionally, shares them with selected roles - so each team shapes the AI tools that fit their content, without a developer.

Key features

• AI Actions dropdown in CKEditor 5 listing the actions available to the current user, plus a free-form "Ask AI..." option (a small inline input, no dialog).
• In-place generation: selecting an action runs the AI and inserts the generated result directly into the editor.
• Voice input (dictation): speak your "Ask AI" or "Tweak" prompt with the microphone instead of typing. The clip is transcribed by a speech-to-text model and run hands-free. The mic button appears only when a speech-to-text model is configured.
• Well-formed HTML (structured output): the AI can return its result as structured data the module renders into clean HTML - paragraphs, headings, lists, bold/italic. Applies to actions and "Explain this", with a plain-text fallback for models that don't support it.
• Distinct highlight colors: separately generated passages - even adjacent ones - get their own color, so they are easy to tell apart at a glance.
• Tracked changes with history: each result shows a small toolbar - previous/next through the generation history, Show original / Show AI version, Regenerate, Tweak, Discard and Keep. Pending changes are locked against accidental edits, and the highlight is never saved.
• "Explain this" read-only insight: explains the selected text - or the whole document when nothing is selected - in a small balloon without changing the content. Available from the dropdown, the on-selection menu, and the tracked-change balloon.
• User-owned actions: actions are content entities. Users create their own from the editor ("Add Action...") and, with an extra permission, share them with selected roles. Private actions stay private.
• Categories: group actions into submenus in the dropdown and sections on the admin listing; uncategorized actions stay at the top level.
• Selection menu (optional): selecting text pops up a small AI Actions menu right at the selection.
• AI Actions on plain text fields (no CKEditor): a standalone twin brings the same experience - menu, "Ask AI...", "Explain this", voice input, and the full review balloon (previous/next, flip, tweak, regenerate, discard, keep) - to plain textfield and textarea fields.
• "Explain any selection" page widget: highlight any text on the page - help text, descriptions, plain content - for a small "Explain this" button and a read-only explanation balloon.
• Whole-document mode: with nothing selected, an action runs on the entire editor content as one tracked change.
• Survives Preview and refresh: pending changes are snapshotted per browser tab and restored when you return from preview or reload - until the content is saved.
• Abuse protection: input and instruction length caps and a configurable per-user hourly rate limit on AI requests.

Screenshots

Configuration

1. Configure your AI provider and set a default chat model at Administration > Configuration > AI (/admin/config/ai/settings). For voice input, also set a default speech-to-text model.
2. Add the AI Actions button to the CKEditor 5 toolbar of the relevant text formats, at Text formats and editors.
3. Grant the module's permissions to the appropriate roles.
4. Manage actions and categories at Administration > Configuration > Content authoring > AI Editor Actions.
5. Review the Settings tab: input length, per-user requests per hour, the system and explain prompts, the explain and voice-input models, and whether the selection menu is shown.

Usage

1. Edit content using a text format that has the AI Actions button.
2. Select some text (or nothing, for the whole document) and pick an action from the AI Actions dropdown. For Ask AI..., type - or click the microphone and dictate - what you want, then Generate.
3. A spinner shows while the AI runs, then the result replaces the text and is highlighted.
4. Use the change toolbar to walk the history with previous/next, Show original / Show AI version, Regenerate a fresh version, Tweak to refine the current version with extra instructions, Discard to restore the original, or Keep.
5. Saving stores whichever version is displayed; the highlight itself is never saved.

Users who may create actions also see Add Action... (create one without leaving the editor) and List Actions... (open the management listing in a new tab).

Requirements

• Drupal 10.6+, 11.3+ or 12.
• The AI (ai) module with a configured provider (for example AI Provider OpenAI) and a default chat model. Voice input needs a speech-to-text model (for example OpenAI Whisper); without one the microphone simply does not appear.
• CKEditor 5, Editor and Filter (Drupal core modules).

Built with AI assistance