← Back to Logbook
April 3, 2026 by Quartermaster

The WordPress Block Editor: A Plain-English Guide for Beginners

#beginners #block editor #gutenberg #tutorial #wordpress

By The Quartermaster // March 31, 2026 // 9 min read // WordPress Fundamentals

The WordPress block editor is how you create and edit content in WordPress. Every piece of content — a paragraph, an image, a heading, a video embed — is its own “block” that you can add, move, customize, and rearrange independently. It replaced the old Classic Editor in WordPress 5.0 back in December 2018, and it is now the default editing experience for over 42% of all websites on the internet.

If you have ever opened a WordPress post and felt overwhelmed by the interface, this guide fixes that. No jargon, no assumptions, no skipping steps. By the end, you will know how to add blocks, move them around, use patterns to build pages faster, and work with keyboard shortcuts that save real time.

⚡ Key Takeaways

  • Every piece of content in WordPress is a “block” — paragraphs, images, headings, videos, buttons, and more
  • WordPress 6.8 includes 113 core blocks across 6 categories
  • Block patterns let you insert pre-designed layouts with one click
  • Synced Patterns (formerly Reusable Blocks) update everywhere when you edit them in one place
  • The slash command (/) is the fastest way to add blocks — type /image or /heading in any empty block

WordPress Block Editor - What Is Block Editor

What Is the WordPress Block Editor?

The WordPress block editor — codenamed Gutenberg — is a visual content editor where everything you create is a modular block. A paragraph is a block. An image is a block. A heading, a list, a button, a video embed, a table — all blocks. You build pages by stacking these blocks in whatever order you want.

Before the block editor, WordPress used the Classic Editor — essentially a single text box with a toolbar (similar to Microsoft Word). It worked, but it was limited. If you wanted columns, custom layouts, or embedded content, you needed shortcodes, page builders, or custom HTML. The block editor makes all of that visual and drag-and-drop.

264M+

posts written with the block editor since launch

Source: GutenStats, 2026

WordPress co-founder Matt Mullenweg described the vision behind the block editor this way:

“The Editor is just the beginning. Blocks will become a fundamental part of site templates, and designs in upcoming phases.”

Matt Mullenweg, Co-founder of WordPress

That vision has been realized. WordPress is now in Phase 3 of the Gutenberg project — collaboration features like real-time co-editing. Blocks are not just for posts anymore. They control entire site layouts through Full Site Editing, which grew 145% in 2025.

For a visual walkthrough, WPBeginner has the best beginner tutorial on YouTube:

WordPress Block Editor - How Blocks Work

How Blocks Work — The Core Concept

A block is a self-contained unit of content with its own settings. When you click on a block, a toolbar appears above it with formatting options specific to that block type. An image block shows alignment and cropping tools. A paragraph block shows text formatting. A button block shows color and link options.

WordPress 6.8 ships with 113 core blocks organized into six categories:

CategoryWhat It ContainsExamples
TextWritten content blocksParagraph, Heading, List, Quote, Code, Table
MediaVisual and audio contentImage, Gallery, Video, Audio, Cover
DesignLayout and structureColumns, Group, Spacer, Separator, Buttons
WidgetsDynamic contentLatest Posts, Archives, Search, RSS
ThemeSite structure elementsSite Title, Navigation, Query Loop, Post Title
EmbedsThird-party contentYouTube, Twitter/X, Spotify, Vimeo

Plugins can add their own blocks too. WooCommerce adds product blocks, Rank Math adds SEO blocks, and contact form plugins add form blocks. The full list of 113 core blocks is in the official developer reference. The ecosystem is massive.

WordPress Block Editor - Essential Blocks

Essential Blocks Every Beginner Should Know

You do not need to learn all 113 blocks. You need about 10. These are the blocks that show up in virtually every post and page.

Paragraph — The default block. Start typing and you are already in one. Handles text, inline links, bold, italic, and basic formatting.

Heading — H2 through H6 headings for structuring your content. Good heading structure is critical for SEO — your H1 is the post title, H2s are major sections, H3s are subsections.

Image — Upload, drag-and-drop, or select from your media library. Includes alt text, caption, link, and sizing options right in the block settings.

List — Ordered (numbered) or unordered (bulleted) lists. Supports nested items by pressing Tab to indent.

🏴‍☠️ PIRATE TIP: Type / in any empty block to open the quick inserter. Then type the block name — /image, /heading, /columns. This is dramatically faster than clicking the + button and browsing the full block library every time.

Gallery — Multiple images in a grid layout. Great for portfolios, product photos, or before-and-after comparisons.

Columns — Side-by-side content layouts. Choose from preset ratios (50/50, 30/70, etc.) or customize. Each column is its own container that accepts any other blocks inside it.

Buttons — Call-to-action buttons with customizable text, colors, border radius, and link. Can add multiple buttons in a row.

Cover — A full-width image or video with text overlay. Perfect for hero sections, section dividers, or visual breaks in long content.

💡 Want more WordPress guides that skip the fluff and get straight to the code? Check out our full library.

WordPress Block Editor - Block Patterns

Block Patterns and Synced Patterns

Block patterns are pre-designed groups of blocks that you insert with one click. Instead of building a hero section from scratch — adding a Cover block, then a Heading, then a Paragraph, then a Button — you grab a hero pattern that has all of those blocks already arranged and styled.

WordPress includes dozens of built-in patterns, and your theme likely adds more. Access them by clicking the + button and switching to the Patterns tab.

Synced Patterns (formerly called reusable blocks) are even more powerful. A synced pattern is a saved group of blocks that updates everywhere when you edit it in one place. Create a newsletter signup box as a synced pattern, place it on 20 pages, and when you change the heading text — all 20 pages update automatically.

Unsynced patterns are templates. Insert one, customize it freely, and changes only affect that specific instance. Use synced for content that must stay identical across your site. Use unsynced for layouts you want to reuse but customize each time.

WordPress Block Editor - Tips Tricks

10 Tips for Working Faster in the Block Editor

The block editor has a learning curve, but these shortcuts flatten it fast.

  1. Use slash commands. Type / in an empty block, then the block name. /image, /heading, /table. Faster than the inserter every time.
  2. Use Markdown shortcuts. Type ## + space for H2, ### + space for H3, - + space for a bullet list, 1. + space for a numbered list.
  3. Ctrl+Shift+D duplicates a block. Select any block and duplicate it instantly. Beats copy-paste for repeating similar elements.
  4. Use List View (three stacked lines icon) to see your document structure. Drag and drop blocks in List View to rearrange large sections without scrolling.
  5. Group blocks together by selecting multiple blocks (Shift+click) then pressing Ctrl+G. Groups can have their own background color and padding.
  6. Ctrl+K inserts a link. Select text, press Ctrl+K, paste or type the URL. Faster than clicking the link icon.
  7. Use the Top Toolbar option (three-dot menu > Top Toolbar) to pin all block toolbars to the top of the editor. Prevents the floating toolbar from blocking your view.
  8. Copy and paste blocks between posts. Select a block, Ctrl+C, open another post, Ctrl+V. All formatting carries over.
  9. Press Escape to select the parent block. If you are editing text inside a Columns block, press Escape to select the column, then Escape again to select the Columns group.
  10. Alt+Shift+H shows all keyboard shortcuts. The full list is always one shortcut away.

The complete official shortcut reference is at wordpress.org.

WordPress Block Editor - Classic Vs Block

Block Editor vs Classic Editor: When to Use Which

The Classic Editor plugin still has over 9 million active installations. WordPress has committed to supporting it through at least 2026. So which should you use?

Use the block editor if:

  • You are starting a new site or new content
  • You want visual page building without a third-party plugin
  • You plan to use Full Site Editing or block themes
  • You want access to block patterns and modern layouts

Use the Classic Editor if:

  • You have a legacy site with complex shortcode-based layouts that break in the block editor
  • Critical plugins on your site specifically require the Classic Editor
  • You are more comfortable with the familiar WYSIWYG interface and do not need advanced layouts

🏴‍☠️ PIRATE TIP: The hybrid approach works too. Install the Classic Editor plugin and set it to allow users to choose per post. Some posts get the block editor, some get the Classic. You do not have to go all-or-nothing.

For new sites in 2026, the block editor is the clear default. Every new WordPress feature — Full Site Editing, block themes, synced patterns, the Site Editor — is built around blocks. Learning it now is an investment that pays off on every project going forward.

Frequently Asked Questions

Is the WordPress block editor the same as Gutenberg?

Yes. Gutenberg is the project codename for the WordPress block editor. It was introduced in WordPress 5.0 in December 2018 and is now the default editor. The name comes from Johannes Gutenberg, inventor of the printing press.

Can I use the block editor and the Classic Editor at the same time?

Yes. Install the Classic Editor plugin and set it to “Allow users to switch editors.” This lets you choose which editor to use on a per-post basis. Some content can use blocks while other posts use the classic interface.

How do I add a block in the WordPress block editor?

Three ways: click the blue + button in the top toolbar, click the + that appears between blocks, or type / in any empty block followed by the block name (like /image or /heading). The slash command is the fastest method.

What are Synced Patterns in the WordPress block editor?

Synced Patterns (formerly called Reusable Blocks) are saved groups of blocks that stay linked. When you edit a synced pattern in one place, the changes apply everywhere that pattern is used. They are ideal for elements like newsletter signups, CTAs, or footers that appear on multiple pages.

Will the Classic Editor be discontinued?

The Classic Editor plugin is officially supported through at least 2026. WordPress has not announced a specific end-of-life date, but all new WordPress development focuses on the block editor. Long-term, blocks are the future.

⚔️ Pirate Verdict

The WordPress block editor had a rough launch in 2018, but the 2026 version is genuinely good. Over 264 million posts have been written with it. Full Site Editing grew 145% last year. Blocks are not a trend — they are the platform now. If you are still clinging to the Classic Editor out of habit rather than necessity, it is time to make the switch. Spend 30 minutes with the block editor, learn the slash commands and keyboard shortcuts, and you will wonder why you waited this long.

Start Building With Blocks Today

The WordPress block editor is the future of content creation on the platform that powers 42.6% of the web. Whether you are writing your first blog post or redesigning your entire site, blocks give you the flexibility to build exactly what you want — no page builder plugins, no custom code, no limitations.

Open a new post, hit that / key, and start experimenting. Every block you learn is a tool in your toolkit. The more you use, the faster you build.

What was the first block that made you realize the block editor was worth learning? Drop it in the comments.

← WordPress Reusable Blocks (Synced Patterns): The Complete Guide (2026) WordPress Hooks Explained: What Actions and Filters Actually Do →
The Quartermaster
> THE QUARTERMASTER
Identify yourself, pirate. What brings ye to the command deck?