TL;DR: The WordPress block editor (Gutenberg) is the default content editor built into WordPress 6.7, letting you build pages and posts by stacking and arranging visual blocks. For users who want a powerful editor they control, Gutenberg is the most capable free option available — but if you want to skip the learning curve entirely, GigaPress AI Builder generates a complete WordPress site in about 15 minutes without touching a single block.
Last Updated: October 2026
The WordPress Gutenberg Block Editor: A Complete Guide for 2026
Try GigaPress AI Free →
The WordPress Gutenberg block editor transformed the way WordPress sites are built. Introduced in WordPress 5.0 in 2018 and now deeply integrated into WordPress 6.7, Gutenberg replaces the old TinyMCE text editor with a visual, block-based system where every element — a paragraph, image, button, or video — is its own self-contained block you can move, style, and configure independently.
Whether you are publishing your first blog post or building a full website without touching a single line of code, this guide covers everything you need to know: core blocks, block patterns, Full Site Editing, reusable blocks, the Query Loop block, and how classic and block themes differ. By the end, you will have a clear picture of how Gutenberg works — and when it makes sense to use an AI-assisted alternative instead.
What Is the Gutenberg Block Editor?
Gutenberg is the name of the project that became WordPress’s default block editor. The name comes from Johannes Gutenberg, who invented the printing press. The WordPress project adopted the same philosophy: modular, composable pieces that combine to create finished pages.
In practical terms, Gutenberg replaces the single text-input field of the classic editor with a canvas where you insert discrete blocks. Each block has its own toolbar, settings panel, and style controls. The editor saves content as structured block markup stored in post meta, which WordPress then renders on the front end.
As of WordPress 6.7 (running on PHP 8.3 for best performance), Gutenberg powers not only the post editor but also the Site Editor, where block themes let you edit headers, footers, templates, and global styles — all through the same block interface.
Core Blocks Overview: The Building Blocks of Every WordPress Page
WordPress ships with more than 90 core blocks out of the box. They are grouped into logical categories so you can find what you need quickly.
Text Blocks
The Paragraph block is the most-used block on any site — it handles standard body copy. The Heading block lets you choose from H1 through H6, with direct controls for font size, color, and alignment. List, Quote, Code, Preformatted, and Table blocks round out the text-heavy toolkit.
Media Blocks
The Image block supports alt text, captions, links, and aspect-ratio cropping directly from the editor. The Gallery block renders a responsive grid of images. The Video, Audio, Cover, and Media and Text blocks give you flexible multimedia layouts without plugins. For faster page loads, pair these with proper WordPress lazy loading so off-screen images only load when needed.
Design and Layout Blocks
The Group block is a container that wraps other blocks and lets you set background colors, padding, and margins. The Columns block creates multi-column layouts without CSS. The Row and Stack blocks (added in WordPress 6.x) provide Flexbox-style horizontal and vertical layouts. The Spacer and Separator blocks control whitespace and visual dividers.
Widget and Embed Blocks
The Shortcode and Classic blocks preserve compatibility with legacy content. Embed blocks for YouTube, Vimeo, Twitter/X, Spotify, and dozens of other services let you paste a URL and get a rich embed automatically.
Block Patterns: Pre-Built Layouts You Can Customize in 2026
Block patterns are pre-designed combinations of blocks that you can insert with a single click and then customize. Think of them as templates for sections — a hero section, a three-column feature grid, a testimonials row, or a call-to-action banner.
To insert a block pattern, open the block inserter (the “+” icon in the top-left of the editor), then click the Patterns tab. WordPress displays patterns from the WordPress.org pattern directory as well as patterns bundled with your active theme.
Developers and advanced users can register custom patterns with register_block_pattern(). You can also create and save your own patterns directly in the editor — build a block arrangement, select all the blocks, open the block options menu, and choose “Create Pattern.” Your pattern then appears in the Patterns tab on every page and post.
Block patterns dramatically speed up page building. Instead of recreating a complex hero section from scratch each time, insert the pattern and swap out the text and images. In 2026, the WordPress.org Pattern Directory contains thousands of community-contributed patterns covering nearly every layout use case.
Classic Themes vs. Block Themes: What Is the Difference?
Understanding the difference between classic and block themes is one of the most important concepts in modern WordPress development.
| Feature | Classic Theme | Block Theme |
|---|---|---|
| Template editing | PHP files (header.php, footer.php) | HTML block templates via Site Editor |
| Style customization | Customizer (widgets, menus) | theme.json + Global Styles panel |
| Full Site Editing | Not supported natively | Fully supported |
| Gutenberg block editor | Supported for post/page content | Supported everywhere (templates, patterns) |
| Learning curve | Lower for page content, higher for layout | Slightly higher initially, then more flexible |
| Default theme example | Twenty Twenty-One | Twenty Twenty-Five |
| Best for | Simpler blogs, legacy compatibility | Full design control without code |
With a classic theme like Twenty Twenty-One, Gutenberg manages your post and page content. Headers, footers, and sidebars are controlled by PHP template files and the Customizer. Changing the global layout requires theme knowledge or a page builder plugin.
With a block theme like Twenty Twenty-Five (the current WordPress default), the Site Editor replaces the Customizer entirely. Every part of the site, from the navigation menu to the footer copyright line, is a block you can edit visually. Block themes use a theme.json file to define typography scales, color palettes, spacing presets, and block defaults — making global design changes fast and consistent.
Full Site Editing (FSE): How to Edit Your Entire Site with Blocks
Full Site Editing, often abbreviated as FSE, is the feature set that lets you edit every visual element of your WordPress site using blocks — not just the content area. FSE requires a block theme.
To access the Site Editor, go to Appearance > Editor in your WordPress dashboard. You will see a navigation panel on the left with sections for:
- Templates — Edit how individual post types, archives, and pages are structured (e.g., the Single Post template, the Archive template, the 404 template).
- Template Parts — Edit reusable site sections like the header and footer.
- Patterns — Browse, create, and manage synced and unsynced patterns.
- Styles — Switch between style variations and customize global typography, colors, and spacing.
- Navigation — Build and edit menus using the Navigation block.
- Pages — Browse and edit individual pages directly from the Site Editor canvas.
FSE represents a significant shift in how WordPress is used. A designer or content editor can now make site-wide changes — update the header layout, change the global accent color, add a sitewide banner — without touching a PHP file or hiring a developer. This capability is central to what makes modern WordPress competitive with visual website builders.
Reusable Blocks (Now Called Synced Patterns)
Reusable blocks were renamed to Synced Patterns in WordPress 6.3. The concept is the same: a block or group of blocks you save once and reuse across multiple posts and pages. When you update a synced pattern in one location, the change propagates everywhere that pattern appears on your site.
Common use cases for synced patterns include:
- A sitewide call-to-action banner that appears at the bottom of every blog post
- A contact information block used in multiple pages
- A disclaimer or legal notice that must stay consistent across content
- A promotional offer block that you want to update globally in one edit
To create a synced pattern, select the blocks you want to save, open the block toolbar options, and choose Create Pattern. Check the “Synced” option in the dialog. The pattern is then stored in the WordPress database as a post type (wp_block) and accessible from the Patterns tab in the block inserter.
You can also create unsynced patterns — starting templates that you can customize independently on each page, without changes propagating globally. Unsynced patterns are useful for layouts you want to reuse as a starting point but customize per page.
The Query Loop Block: Dynamic Content Without Custom Code
The Query Loop block is one of the most powerful core blocks in WordPress. It lets you display dynamic lists of posts, pages, or custom post types anywhere on your site — without writing a WP_Query loop in PHP.
A standard use case: you want to show the three most recent posts from a specific category on your homepage. In a classic theme, this typically required a custom PHP template. With the Query Loop block, you configure it directly in the editor by selecting the post type, filtering by category or tag, setting the number of posts, choosing an order, and picking an inner template that controls how each result is displayed (title, excerpt, featured image, date, etc.).
The Query Loop block is made up of inner blocks including:
- Post Template — defines the layout for each query result
- Post Title — renders the post title as a link
- Post Excerpt — shows the post excerpt
- Post Featured Image — displays the featured image
- Post Date — shows the publish or modified date
- Post Author — renders author name and avatar
- Pagination — adds numbered pagination or load-more controls
This composable structure means you can design exactly the post card layout you want, then have WordPress populate it dynamically with real content. The Query Loop block is central to building archive pages, blog feeds, portfolio grids, and news listings in block themes — all without a plugin or developer.
Practical Tips for Beginners Using the Block Editor
If you are new to the WordPress Gutenberg block editor, these tips will help you move faster and avoid common frustrations.
- Use the slash command. Type “/” anywhere on the canvas to open an inline block search. Type a block name like “image” or “table” and press Enter to insert it instantly — no need to use the “+” icon every time.
- Use keyboard shortcuts. Ctrl+Z (Cmd+Z on Mac) undoes, Ctrl+Shift+Z redoes. Ctrl+Shift+D duplicates a block. Ctrl+Alt+T inserts a block above, Ctrl+Alt+Y inserts below. The full list is available in the editor under the three-dot menu at the top right.
- Switch between visual and code view. Click the three-dot menu in the top-right toolbar and choose “Code Editor” (Ctrl+Shift+Alt+M) to see and edit the raw block markup. This is useful for debugging or making precise edits.
- Use List View for complex pages. Click the List View icon (three horizontal lines) in the top toolbar to see a tree of all blocks on the page. You can drag and drop to reorganize them or click to jump to any block quickly.
- Lock blocks to prevent accidental edits. Select a block, open the three-dot menu, and choose “Lock” to prevent it from being moved or deleted. Useful when building templates for clients or less-experienced editors.
- Group blocks before styling. If you want multiple blocks to share a background color or padding, select them all and click “Group” from the block toolbar. Then apply styles to the Group block, which acts as a container.
Advanced Tips for Power Users
Experienced WordPress users can push Gutenberg significantly further with these techniques.
- Use theme.json for global design control. Instead of adding custom CSS for every block, define global settings in your block theme’s
theme.json. Set color palettes, font size scales, spacing scales, and default block styles in one structured file. Refer to the WordPress Developer Resources for the completetheme.jsonschema. - Register custom block styles. Use
register_block_style()to add additional style variations to core blocks. For example, add a “Boxed” style to the Image block or a “Ghost” style to the Button block. Users can then apply these in the editor via the Styles panel. - Build custom blocks with the @wordpress/create-block package. Run
npx @wordpress/create-block my-blockto scaffold a new block plugin. The generated code uses modern JavaScript with the @wordpress/scripts build toolchain. - Use the Interactivity API for dynamic blocks. Introduced in WordPress 6.4 and stabilized in 6.5, the Interactivity API lets you add client-side behaviors (accordion toggles, tab switching, live filters) to blocks using declarative HTML attributes — no custom JavaScript framework required.
- Combine the Query Loop block with custom post types. Register custom post types in your theme or a plugin, then use the Query Loop block’s post type filter to display them. This is a clean, no-plugin approach to portfolio, testimonials, or events sections.
- Optimize for page speed. Complex block layouts can add DOM depth. Review your WordPress page speed regularly, especially if you use many Group blocks or large background images.
When the Block Editor Is Not the Right Tool
The Gutenberg block editor is powerful, but it is not the fastest path to a finished site for everyone. Consider these scenarios where an alternative approach makes more sense.
You need a complete site, not just pages. Gutenberg excels at editing content within a site, but setting up the whole WordPress environment — hosting, theme, plugins, initial content, images, colors — still requires time and technical decisions. A non-developer launching a small business site often spends more time configuring WordPress than actually running their business.
You want AI-generated content and design together. The block editor is a manual tool. It does not write your copy, choose your color palette, or generate your hero image. AI-powered alternatives handle that entire layer.
You are building sites for clients at scale. Agencies building many sites per month often find that per-site Gutenberg setup time adds up. Faster generation pipelines reduce that overhead significantly.
For context on how the block editor fits into the broader landscape of ways to build on WordPress, the WordPress hosting guide on this site walks through the infrastructure choices that underpin any WordPress build.
Want a Pro WordPress Site in Minutes?
GigaPress AI builds you a full WordPress site in about 15 minutes — AI handles layout, styling, content, and images. Free to design, only pay when you’re ready to go live. If manually arranging blocks, choosing fonts, and configuring templates sounds like more work than you want, GigaPress AI generates a complete, SEO-ready WordPress site for you without touching a single block.
Frequently Asked Questions About the WordPress Block Editor
Is the Gutenberg block editor the same as the classic WordPress editor?
No. The classic editor was a single TinyMCE-based text field similar to Microsoft Word. The Gutenberg block editor replaces it with a modular canvas where every element — text, image, button, video — is a separate block with its own controls. The Classic Editor plugin can restore the old experience, but it is a legacy option and will not receive new features.
Do I need a block theme to use the Gutenberg block editor?
No. You can use the Gutenberg block editor to create post and page content with any theme, including classic themes. However, Full Site Editing — editing your header, footer, and global templates through the Site Editor — requires a block theme. If you want the full block-editing experience across your entire site, switching to a block theme like Twenty Twenty-Five is the right move.
What is the difference between a synced pattern and a reusable block?
They are the same feature under different names. WordPress renamed “reusable blocks” to “synced patterns” in version 6.3 to better reflect how they work alongside the broader Patterns system. Both refer to a saved block arrangement that updates globally across all instances when you edit it.
Can I use the Query Loop block with a classic theme?
Yes. The Query Loop block works within post and page content in any theme. However, to use it in headers, footers, or archive templates, you need a block theme and access to the Site Editor. In a classic theme, it is only available where the standard block editor is active — in post and page edit screens.
Will the Gutenberg block editor slow down my WordPress site?
The block editor itself does not slow down your front end — it is an admin-only tool. What can affect front-end speed is the complexity of block markup you output, such as deeply nested Group blocks or large inline images. Keep your block layouts clean, use a good caching plugin, and follow established WordPress page speed optimization practices to keep load times fast regardless of which editor you use.
How do I update my WordPress site’s automatic core updates to stay on the latest version of Gutenberg?
Gutenberg improvements ship with every WordPress core update. To keep Gutenberg current, enable automatic WordPress core updates so you always run the latest stable release. The WordPress automatic updates guide walks through how to configure this safely, including how to exclude plugin and theme updates if you want more control over those separately.
