AI Block Editor
AI Block Editor
Description
AI Editor adds an OpenAI-powered assistant to the Gutenberg editor sidebar. Ask it to add new content, build page sections, or update selected blocks, and it will work with Gutenberg block markup directly.
AI Editor supports core Gutenberg blocks for new insertions. When your active theme exposes theme.json settings, AI Editor can use those site styles, presets, colors, spacing, typography, gradients, image sizes, and layout widths so generated blocks stay closer to your existing design system and available block options.
Features
- Natural language block creation: Describe your desired content in plain language and the AI will handle the rest.
- All core Gutenberg blocks for insertion: AI Editor can insert supported
core/*Gutenberg blocks using canonical block markup. - Selected block editing: Select one or more blocks in Gutenberg and ask AI Editor to update the selected content or layout.
- Custom block editing: Custom and third-party blocks can be edited after you add and select them manually. AI Editor uses the markup it can see for the selected block, so review the result because custom blocks may have private fields, dynamic rendering, or plugin-specific rules the AI cannot fully infer.
- Theme-aware output: Uses active editor/theme settings, including theme.json presets when available, to keep generated layouts more consistent with your site’s colors, spacing, typography, and block options.
- Resizable sidebar: Drag the left edge of the AI Editor sidebar to make the chat panel wider.
- GPT model selection: Choose from supported GPT models, with GPT-5.5 recommended by default when available for your API key.
- Reasoning effort controls: Choose how much reasoning the model should use for faster simple edits or more careful complex layout work.
- Conversation context controls: Limit how many recent chat messages are sent with each request.
- Prompt caching: AI Editor keeps repeated system instructions stable so OpenAI prompt caching can reuse shared context when available, helping monitor API usage and reduce repeated input processing.
- Theme compatibility check: Review whether the active theme is a good fit for AI Editor’s Gutenberg and theme style workflow.
- BYOK: Use your own OpenAI API key.
- Language translation: Multilingual support.
Prompt Examples
- “Add this article as a magazine-style layout using blocks: (paste article here).”
- “Create a layout for an About Us page, including sections for a mission statement, team members, and contact.”
- “Add 3 columns, each with a pricing plan.”
- “Create a table comparing the caffeine content of popular drinks.”
- “Rewrite this testimonial block to sound more concise.”
- “Update the selected columns for better balance.”
Getting The Best Results
- Quickly add content blocks: Ask AI Editor to add headings, sections, buttons, lists, tables, columns, and other core blocks for your content.
- Turn full copy into blocks: Paste a full page draft or section copy and ask AI Editor to convert it into Gutenberg blocks. You can guide which blocks to use, or let AI Editor choose the block structure.
- Use the latest recommended model: For the best results, use the latest supported model available to your OpenAI account. GPT-5.5 with reasoning set to
mediumis a good starting point for more complex layouts. - Select the right amount of content: If the change depends on a parent layout, columns, group spacing, or surrounding section structure, select the whole relevant block or section and say what you want changed.
- Use narrow selections for simple edits: If you only need a specific text, button, heading, or single block changed, select just that block and give a direct instruction.
Settings
Navigate to Settings -> AI Editor to configure the plugin.
- OpenAI API Key: Add your own OpenAI API key. Requests are sent from your WordPress site to OpenAI.
- GPT Model: Choose the model AI Editor should use. The settings page marks the recommended model.
- Reasoning Effort: Choose
none,low,medium,high, orxhigh. Lower values are faster for simple edits; higher values can help with larger layouts or more careful restructuring but may take longer and use more tokens. - Theme Style Context For AI: A short style note used as design direction. AI Editor can rewrite the active theme description with AI. Raw theme presets are handled separately, so this field should stay short and human-readable.
- Limit Conversation Context Sent To OpenAI: Turn on/off trimming of older chat messages before sending a new request.
- Max Messages In Conversation Context: Set how many recent messages are kept when conversation context trimming is enabled.
- Theme Compatibility For AI Editor: Run a compatibility check for the active theme. It reviews Gutenberg support, block theme signals, editor style support, and available theme presets so you can spot where manual cleanup may be needed.
Note: AI Editor is powered by OpenAI’s GPT technology. For more information on the data handling and privacy aspects, please refer to OpenAI’s Privacy Policy and Terms of Service.
Requirements
PHP 7.0+ is recommended, WordPress 5.8+, with Gutenberg active. An OpenAI API key is required.
Installation
- From your WordPress dashboard, go to Plugins > Add New.
- Search for AI Editor in the Search Plugins box.
- Click Install Now to install the AI Editor Plugin.
- Click Activate to activate the plugin.
- In the WordPress menu, go to Settings -> AI Editor to add your OpenAI API key and select the desired GPT model.
- Open the Gutenberg editor for your post or page.
- Click on the three dots in the top-right corner to expand the options menu.
- Under the Plugins section, click on AI Editor to enable the AI sidebar.
- Once the AI Editor sidebar appears, you may click the star icon at the top of it. This action pins the AI Editor to the toolbar for quick access.
- Ask the AI to add blocks or layouts by providing descriptions.
Screenshots
Faq
Gutenberg is the modern block-based editor in WordPress, allowing users to create content using a variety of blocks.
Once installed, go to the Gutenberg editor, enable the AI Editor sidebar, and start adding blocks by describing to the AI what you need.
Yes, an OpenAI API key is required to use the AI Editor. You can enter your API key in the plugin settings.
- AI Editor can insert core Gutenberg blocks. Custom and third-party blocks should be added manually first, then selected for editing.
- Custom block edits depend on the selected markup AI Editor can see. Some custom blocks store data outside saved markup or render dynamically, so AI Editor may make mistakes and you should review the result.
- New image blocks are blank placeholders. AI Editor does not add external image URLs, Unsplash images, generated image sources, or media library items.
- AI Editor uses your theme settings when they are exposed through theme.json. If your theme does not provide theme.json settings, AI Editor cannot see all of your theme styles, so the final look and feel will depend more on your theme’s default styling.
Reviews
Great idea, unfortunately currently limited to very basic block creation only
By yotikewebdesign on April 7, 2026
Setup of the plugin worked well, though manual upload was necessary as plugin is not supported in current version (6.9.4). Added API key and selected GPT 4o (v5 seemed to be missing in drop down). Was able to then access the AI chat in the page builder, and it was able to create a new block. Unfortunately it was not able to change any styling, access external website or any existing block, which really limits its use.
Would be great to see:
- Ability to edit existing page content/blocks.
- Ability to adjust styling
- Able to access external pages to pull content to build pages.
Promising solution to generate AI based content in Gutenberg
By Tomas Frank (franktomas) on November 14, 2024
I tried several solution to get GPT model to Gutenberg, but this one looks very promising. I hope it will be envolved for example to generate title based on content or some how to use custom GPT trained model to have more precise information.
Changelog
1.0.5
- Support for GPT-5.4 and GPT-5.5 models, with GPT-5.5 as the recommended default.
- Selected block editing for one or more selected blocks.
- Theme-aware output using active editor settings and theme.json presets when available.
- Prompt caching for repeated AI Editor system instructions.
- Reasoning-effort settings for balancing speed and more careful layout work.
- Conversation context controls.
- Theme style context generation from the active theme description.
- Theme compatibility checks for AI Editor’s Gutenberg workflow.
- Resizable AI Editor sidebar.
- Updated translation template and added translator comments for placeholder strings.
1.0.4
Added GPT-4.1 model.
1.0.3
Added GPT-4o mini model.
1.0.2
UI updates.
1.0.1
Added GPT-4o model.
1.0.0
First release of the plugin.


