What Is a Block in WordPress? The Gutenberg Editor Explained

A block is one piece of content with its own settings. A paragraph is a block. An image is a block. A button, a heading, a table, a video embed — each is a block you can select, move and configure independently.

That is the entire idea. Everything else in the editor is a consequence of it.

Why it is called Gutenberg

Gutenberg was the codename for the project that replaced the old single text box with the block editor, and it shipped in WordPress 5.0. The name stuck, so three related things now share it:

• The block editor in core — what you use when you edit a post. This is what almost everyone means.
• The Gutenberg plugin — an optional plugin where new editor features are developed and released early, ahead of core. You do not need it, and on a production site you generally should not run it.
• The wider project — the multi-phase effort that produced block themes and the Site Editor, extending blocks from post content to the whole site.

So "Gutenberg" and "the block editor" are used interchangeably, and the distinction only matters when someone is talking about the plugin. If you prefer the old editing experience, it can be brought back — see how to restore the classic editor.

The three places settings live

When a block is selected:

1. The toolbar above it — the frequent actions: alignment, bold, link, transform into another block type.
2. The sidebar on the right — everything else: colour, typography, spacing, and block-specific options. Press the settings icon if it is hidden.
3. The options menu (three dots) — duplicate, insert before or after, group, lock, copy, remove.

If you cannot find a setting, it is almost always in the sidebar under a collapsed panel. The Button block links the same way as text — through that toolbar — which is why so many buttons end up saved with no link at all; see how to add a link to a WordPress button for the steps that actually commit the URL.

Blocks worth knowing

Group and Columns are the layout tools

Most layout questions are answered by these two.

Group wraps several blocks into one unit. Give the group a background colour and padding, and everything inside inherits the container — the standard way to build a highlighted section, and the widths and gaps involved are explained further in block spacing and layout.

Columns splits horizontally. Each column is itself a container you can put blocks into. Check the mobile behaviour: columns stack by default, and the stacking order is the source order.

A common structure:

Group (background colour, padding)
└── Columns
    ├── Column: Heading + Paragraph + Button
    └── Column: Image

The list view is the fix for fiddly selection

Click the list view icon in the top toolbar. It shows the block structure as a tree — which is far easier than clicking around trying to select a parent group.

From the list view you can drag blocks to reorder, select a container reliably, and see nesting at a glance. On any page more complex than a few paragraphs, it saves more time than anything else in the interface.

Keyboard and speed

• / at the start of an empty paragraph opens a quick block search — type /image and press enter.
• Enter creates a new paragraph; Shift+Enter makes a line break within one.
• Cmd/Ctrl+Shift+D duplicates the selected block.
• Escape selects the block you are editing, so arrow keys move between blocks.
• Paste from a document and WordPress converts headings and lists into the right blocks automatically.

Patterns and synced patterns

A pattern is a pre-built arrangement of blocks — a hero section, a pricing table, a testimonial row. Insert one and edit it freely; the copy is independent — see WordPress block patterns explained for the full distinction from a synced pattern.

A synced pattern stays linked to its source. Edit it once and every page using it updates. Right for a call-to-action or a notice that must stay identical; wrong for a section you want to customise per page.

Create either by selecting blocks and choosing Create pattern from the options menu. In a block theme they are managed under Appearance → Editor → Patterns — see what is a WordPress block theme.

How blocks are stored

Block content is plain HTML in the post, annotated with comments:

<!-- wp:paragraph -->
<p>Ordinary HTML, with a comment marking the block.</p>
<!-- /wp:paragraph -->

Two useful consequences. Content stays readable and portable — if a block plugin is removed, the HTML remains rather than leaving a shortcode stub. And a block that shows "this block contains unexpected or invalid content" usually just means the markup was edited by hand and no longer matches what the block expects; Attempt block recovery in the warning normally fixes it.

If the editor is giving you trouble

• Blocks missing from the inserter — the plugin providing them is inactive.
• The editor will not load at all — usually JavaScript or the REST API, per Site Editor not loading.
• You would rather have the old editor — see how to restore the classic editor.
• Changes do not appear on the front end — caching, per WordPress changes not showing.