Websites and Tech

Block Editor

Also called Gutenberg

WordPress's editing interface, where every paragraph, image and section is a separate block saved as standard HTML.

Quick facts: Block Editor

Category
Websites and Tech
Also called
Gutenberg
Level
Beginner
Affects
Publishing workflow, page structure, design consistency
Where to see it
WordPress post and site editor, block patterns, reusable blocks
In this article4
  1. How the block editor works
  2. Why the block editor matters
  3. Common mistakes with the block editor
  4. How to use it well

How the block editor works

The block editor, still widely called Gutenberg, treats a page as a stack of blocks rather than one continuous document. A paragraph is a block. So is an image, a heading, a table, a button, a columns layout, an embedded video. Each block has its own settings panel, and blocks can be nested inside container blocks to build a section.

What is saved is ordinary HTML with a comment before each block recording its type and settings. That is worth knowing, because it means the content is readable and portable: if the editor were switched off tomorrow, the text and images would still be there as plain markup. Reusable blocks and patterns build on the same idea, letting you save a section once and drop it into many pages.

Why the block editor matters

It gives a marketing team a way to build richer pages without adding a separate page builder and its weight. Callouts, comparison tables, step lists and quote panels can be built from the platform’s own blocks and styled by the theme, so the page stays light and the markup stays clean.

It also draws a useful line. Because blocks are defined by the theme or a plugin, a developer can set out the components an editor is allowed to use, and the editor works inside them. That produces a site where pages look related to each other rather than each carrying a designer’s mood on the day it was written.

Common mistakes with the block editor

The complaint you hear most is invalid block content. It happens when the markup saved in the database no longer matches what the block’s own code expects to produce, usually after a plugin update or after someone edited the HTML by hand. The recovery options are unhelpful under pressure, so the habit worth forming is not editing block markup directly.

The second is over-nesting: columns inside groups inside covers, until a small text change means hunting through four levels. The third is a heading used for its size rather than its meaning, which produces a page that looks organised and reads, to a search engine, as noise. The fourth is building the same section by hand on twenty pages instead of saving it as a pattern.

How to use it well

Agree a small set of blocks the team actually uses and stick to it. Save recurring sections as patterns or reusable blocks so a wording change happens once. Keep headings in order and let the theme handle the styling, rather than adjusting colours and font sizes on individual blocks, which is what makes a site drift over time.

When something goes wrong, check whether a plugin that registers blocks has just been updated, since that is the usual cause. And treat the block list as a design decision rather than an afterthought: a well-chosen set of components is what keeps content quick to publish and consistent to read, which is the whole aim of any WordPress development that has to be handed over to a non-technical team.

Do and do not

Do

  • Save recurring sections as patterns or reusable blocks
  • Keep headings in order and use them for meaning
  • Agree a short list of approved blocks

Do not

  • Edit block markup by hand in the code view
  • Nest groups and columns more than necessary
  • Restyle colours and sizes on individual blocks

Questions people ask about this

What does 'this block contains unexpected or invalid content' mean?

The HTML stored for that block no longer matches what the block's code expects to output. It usually follows a plugin or theme update, or someone editing the markup by hand. You can attempt a block recovery, convert it to plain HTML to keep the content safe, or rebuild the block. Take a copy of the text first.

Can I still use the classic editor?

Yes. A maintained plugin restores the older editing screen, and some sites keep it because their layouts depend on shortcodes built for it. It is a reasonable short-term choice, but new features are built for the block editor, so treat it as a delay rather than a permanent decision.

Is the block editor the same as a page builder?

They overlap but are not the same. The block editor is part of WordPress and saves standard HTML, so content survives if it is disabled. A page builder is an added plugin with its own storage format, usually offering finer layout control at the cost of extra weight and harder migration later.

Related terms

Found this useful?

Share it, or ask an AI to summarise it

Back to the glossary

Knowing the term is the easy part

Applying it to your own site and budget is the work. Book a call and I will tell you what actually applies to you.