WordPress glossaryThe WordPress editor is the screen where posts and pages are written and laid out. Since WordPress 5.0 it has been the block editor, also known as Gutenberg.
The WordPress editor is where content gets made: the screen that opens when you add or edit a post or page. Since WordPress 5.0, released in December 2018, that screen has been the block editor, developed under the project name Gutenberg. It treats every piece of a page (a paragraph, heading, image, button, or columns layout) as a separate block that can be added, moved, styled, and reused on its own.
Block editor and classic editor
Before 5.0, WordPress used what is now called the classic editor: one large text box with a formatting toolbar, much like a word processor. Layouts beyond text and images needed shortcodes, custom fields, or a page builder plugin.
The block editor replaced it with a visual canvas. Each block has its own toolbar and its own settings in the sidebar, and the page looks close to how it will on the live site. Behind the scenes, blocks are saved as ordinary HTML with small comments that tell WordPress where each block starts and ends, so the content stays readable even without the editor.
The classic editor is still available through the official Classic Editor plugin, and inside the block editor there is a Classic block for content that needs the old toolbar. Sites built around the classic editor, or around a page builder, can keep working that way.
Editing tools
- Block inserter: the plus button, or typing
/followed by a block name in an empty paragraph. - Settings sidebar: options for the whole post (status, categories, featured image, excerpt) and for the selected block (colors, typography, spacing).
- List view and document overview: an outline of every block and heading, handy for long pages and for checking that headings are in order.
- Patterns: ready-made groups of blocks, such as a hero section or a pricing table. Synced patterns, called reusable blocks before WordPress 6.3, update everywhere they are used when one copy is edited.
- Code editor: from the options menu, shows the post's raw block markup for quick fixes.
- Revisions: earlier versions of the post that can be compared and restored.
The Site Editor
With a block theme, the same editing approach extends beyond posts to the whole site. The Site Editor, under Appearance, then Editor, arrived with WordPress 5.9 and lets you edit templates, the header and footer, navigation, and global styles such as fonts and colors, all with blocks. Classic themes do not use the Site Editor; their layout still comes from PHP templates and the Customizer.
Working well in the editor
- Use real headings. Heading blocks create a proper outline for readers, screen readers, and search engines. Do not fake headings with bold text.
- Write image alt text in the image block's settings as you add each image.
- Save layouts as patterns instead of rebuilding them, and use synced patterns for content that must stay identical everywhere.
- Keep plugins lean. Every block plugin adds code to the editor and often to the front end.
Troubleshooting
- The editor will not load or shows a blank screen: usually a plugin conflict or a JavaScript error. Deactivate plugins one by one, or check the browser console.
- Updates fail with a "not a valid JSON response" message: the editor saves through the REST API, so a security plugin, firewall, or permalink problem blocking
/wp-json/is the usual cause. - "This block contains unexpected or invalid content": the saved markup no longer matches what the block expects, often after a plugin update. The block's menu offers to attempt recovery.
If you are weighing the block editor against a page builder, our Gutenberg vs Elementor comparison covers the trade-offs.
FAQs
What is the WordPress editor, and how does it work?
It is the screen where posts and pages are written, and since WordPress 5.0 it has been the block editor, also called Gutenberg. Content is built from blocks, such as paragraphs, headings, images, and buttons, each with its own settings, and saved as HTML in the post.
How is the block editor different from the classic editor?
The classic editor is a single text box with a formatting toolbar, like a word processor. The block editor splits content into separate blocks that can be moved, styled, and reused, and shows a much closer preview of the finished page, including layouts like columns that the classic editor could not build on its own.
Can I switch from the block editor to the classic editor?
Yes. Install the official Classic Editor plugin, which can switch the classic editor on for the whole site or let each user choose. Existing block content keeps working. Bear in mind that new WordPress features are built for the block editor.
What are reusable blocks in the WordPress editor?
Reusable blocks, renamed synced patterns in WordPress 6.3, are blocks or groups of blocks saved once and inserted in many places. Editing one copy updates every instance, which suits things like a standard call to action or a disclaimer. Unsynced patterns are starting points that can be changed independently each time.
Is the WordPress editor suitable for beginners?
Yes. Basic writing works like any other editor: type, and press Enter for a new paragraph. The block inserter and patterns let beginners build richer pages without code, and the extra tools can be learned gradually as they are needed.