How to Use the WordPress Block Editor: A Complete Beginner’s Guide

The first time you open WordPress to write a post, you meet the block editor, and it can feel a little strange. There is no big blank page like a word processor; instead there is a mostly empty screen with a plus button, and everything you add, a paragraph, a heading, an image, becomes its own separate “block.” If you have never used it, this can be confusing for about five minutes, and then it clicks and becomes genuinely pleasant to work with. The block editor is how you write posts and build pages in modern WordPress, and once you understand the simple idea behind it, you can create good-looking content without any code or design skill. This guide walks you through it from scratch.

No jargon, no assumptions. By the end you will know what blocks are, how to add and arrange them, which ones you will use most, and the small tricks that make the editor fast and comfortable. If you have just built your site, this is the skill that turns it into a place you actually publish, and our guide to starting a WordPress blog covers the steps before this one.

The one idea behind the block editor

Everything makes sense once you grasp the core concept: in the block editor, your content is built from blocks, and each piece of content is its own block. A paragraph of text is a block. A heading is a block. An image is a block. A button, a list, a quote, a video, each is a block you add and arrange. Instead of one long document, you assemble your page from these pieces, stacking and rearranging them like building bricks. That is the whole model, and it is powerful because each block can be moved, styled, and configured on its own, which is what lets you create varied, structured layouts without touching code. When people say “the block editor” or “Gutenberg,” this is what they mean: a way of building content out of individual blocks rather than typing into one big field. Hold that idea and the rest is just learning which blocks exist and how to handle them.

Getting to the editor and writing your first words

To start, from your WordPress dashboard go to Posts and choose to add a new one (pages work the same way). You land in the editor with a spot for your title at the top and the content area below. Click where it says to add a title and type your post’s title. Then click below it and just start typing; your text automatically becomes a paragraph block. To start a new paragraph, press Enter, and a fresh paragraph block appears. That is genuinely all it takes to write, type your title, type your text, and you are creating content. Everything beyond this, images, headings, and the rest, is about adding other kinds of blocks around your text, but the basic act of writing is exactly as simple as it should be. You do not need to learn anything special to write a post; you type, and the editor handles the blocks for you.

Adding blocks: the plus button

To add anything that is not a plain paragraph, you add a block, and there are a couple of easy ways. The most visible is the plus button: you will see a plus icon, at the top left of the editor and appearing near your content as you work, and clicking it opens a menu of every block you can add. Search or scroll for what you want, an image, a heading, a list, click it, and the block appears in your content ready to use. The other quick way is to type a forward slash on a new line, which brings up a block search right where you are typing, so you can type “/image” or “/heading” and pick it without leaving the keyboard. Both do the same thing, insert a block, so use whichever feels natural. Adding blocks is the heart of building a page, and once you are comfortable reaching for the plus button or the slash command, the whole library of blocks is at your fingertips.

The blocks you will use most

There are many blocks, but a handful cover the vast majority of everyday content, and knowing these is enough to build almost anything.

• Paragraph. Your default text block, and the one you use most. Just typing creates it.
• Heading. For section titles that break up your content and help readers scan. Headings also help SEO, so use them to structure a post.
• Image. Adds a picture, which you can upload or pick from your media library, with options for size and alignment.
• List. For bulleted or numbered lists, like this one, which make information easy to scan.
• Button. A clickable button for a call to action, linking somewhere you want readers to go.
• Quote. For pulling out a quotation or emphasizing a line.
• Columns. Puts blocks side by side for simple layouts, like text next to an image.

Learn these seven and you can write a rich, well-structured post, text broken up with headings, illustrated with images, organized with lists, and finished with a button, using only core blocks and no code at all.

The core blocks at a glance

You will build the great majority of posts from these. When you need something else, the plus button’s full library has a block for it, but master these first and you are equipped for almost any everyday content.

Moving, changing, and deleting blocks

The freedom of blocks is that each one is independent, so you can rearrange your content easily. When you click a block, a small toolbar appears above it with options for that block, and there are arrows or a drag handle to move the block up or down, so you can reorder your content by moving whole blocks rather than cutting and pasting text. The toolbar also offers formatting relevant to that block, text options for a paragraph, alignment and size for an image. To change a block’s type, you can transform it, turning a paragraph into a heading, for example, through that toolbar. And to remove a block, select it and use its options menu, usually shown as three dots, to delete it. These three abilities, move, change, and delete, are what make the editor flexible: you build your page from blocks and then freely rearrange and adjust them until it looks right, all visually, with nothing permanent until you publish.

Publishing and the settings sidebar

When your post is ready, publishing is a click. The Publish button is at the top right; click it, confirm, and your post goes live. Before that, the settings sidebar, which you can open with the gear icon, holds the important extras: setting your featured image, choosing categories and tags to organize the post, writing an excerpt, and other options. It has two tabs, one for the whole post’s settings and one for the currently selected block’s settings, so it is where you go both to configure your post overall and to fine-tune an individual block. You do not have to touch everything here, but knowing the sidebar is where the featured image and categories live saves confusion, since those are not in the main content area. Set your featured image and a category or two, then hit Publish, and you have created and published a real post entirely through the visual editor.

The post editor versus the site editor

One point of confusion worth clearing up early: WordPress has two block-based editing experiences, and beginners sometimes mix them up. The one this guide covers is the post (and page) editor, where you write and build your individual posts and pages, which is where you spend most of your time as a writer. There is also a site editor, used to design the overall structure of your site, headers, footers, and templates, on modern block themes. They share the same block idea, so learning the post editor prepares you for the site editor, but for writing and publishing content, the post editor is all you need. If you open something that looks like it is editing your whole site’s layout rather than a single post, you are in the site editor; step back to Posts to write. Keeping the two straight saves the common beginner moment of feeling lost in the wrong tool, and for your day-to-day publishing, the post editor described here is the one that matters.

Patterns and a few time-savers

Once you are comfortable, a few features make the editor faster. Patterns are ready-made arrangements of blocks, a styled call-to-action, a testimonials section, a header layout, that you can insert and then fill with your own content, which saves building common layouts from scratch. The list view, an outline icon that shows all your blocks as a list, is invaluable on longer posts for finding and selecting blocks quickly, or reordering them by dragging in the list. Keyboard shortcuts speed up formatting, and the slash command keeps your hands on the keyboard while adding blocks. And you can save your own reusable blocks if you use the same content in multiple places. None of these are necessary to start, but as you write more, patterns and the list view especially turn the editor from something you operate carefully into something you move through quickly.

Beginner mistakes to avoid

A few small habits trip up new users, and knowing them saves frustration.

• Not using headings. Writing one long wall of paragraphs makes posts hard to read and worse for SEO. Break content into sections with heading blocks.
• Looking for the featured image in the content area. It lives in the settings sidebar, not in the post body. Open the sidebar to set it, along with categories.
• Fighting the editor instead of learning the plus button. Every element is a block you add; once you reach for the plus button naturally, the whole library opens up.
• Forgetting to preview on the live site. The editor is close but your theme sets the final look, so preview the published post to see the real result.
• Overcomplicating early posts. You do not need columns, patterns, and fancy layouts to publish. Text, headings, and images are plenty; add complexity only as you get comfortable.

Avoid these and the editor feels smooth quickly, rather than like a tool you are wrestling with.

Frequently asked questions

What is the difference between Gutenberg and the block editor?

They are the same thing. Gutenberg is the project name for the block editor, so when people say Gutenberg they mean the block-based editor you use to write posts and pages. You will see both terms used interchangeably. There is no separate tool to learn; the block editor and Gutenberg are one and the same, and it is simply the standard WordPress editor.

Do I need to know HTML or code to use the block editor?

No, and that is the point of it. The block editor is entirely visual, you add and arrange blocks by clicking and typing, and it produces the code behind the scenes for you. You can create well-structured, good-looking posts and pages without ever seeing HTML. Code becomes relevant only if you want to do something advanced beyond what the blocks offer, and even then it is optional for the vast majority of content.

Can I still use the old classic editor?

The block editor is the standard and where WordPress is heading, so it is best to learn it, and it is genuinely nicer once it clicks. A classic-editor option exists for those who need it, usually via a plugin, but relying on it means working against the platform’s direction and missing the block editor’s flexibility. For anyone starting now, learning the block editor is the right investment, since it is the present and future of writing in WordPress.

How do I add an image to my post?

Add an image block, using the plus button or by typing “/image”, then upload a picture from your computer or choose one already in your media library, and it appears in your content. From the block’s toolbar you can align it, change its size, and add a link or caption. It is a simple, visual process, and images are one of the most common blocks you will use to make posts more engaging.

Why do my blocks look different on my live site than in the editor?

The editor tries to show your content close to how it will appear, but your theme controls the final styling, fonts, colors, spacing, so there can be small differences between the editor and the live page. This is normal. After publishing, view your post on the live site to see the true result, and if the styling is not what you want, that is usually a theme setting rather than an editor issue. Previewing on the live site is the reliable way to see exactly how visitors will see it.

How do I add a link in the block editor?

Select the text you want to link, and a small toolbar appears with a link icon; click it, paste or search for the destination, and the link is added. You can link to another page on your own site or to an external site the same way. Linking is done right in the flow of writing, so you do not need a separate step or block for it, just highlight the words and add the link.

Can I undo a change in the editor?

Yes, easily. The editor has undo and redo controls at the top, and the usual keyboard shortcut to undo works too, so you can freely experiment, moving blocks, trying a layout, and step back if you do not like the result. Nothing is permanent until you publish or update, and even then you can keep editing, so you can explore the editor without fear of breaking anything.

What happens to my old posts written in the classic editor?

They continue to work and display fine; the block editor does not break existing content. When you open an older post, it typically appears in a single classic block that holds the original content, and you can leave it as is or convert it to blocks if you want to edit it in the new way. There is no forced migration and no loss, so switching to the block editor does not put your existing posts at risk, they simply keep working while new posts use blocks.

The bottom line

The WordPress block editor looks unfamiliar for about five minutes and then becomes a genuinely pleasant way to create content, once you grasp its one idea: your page is built from blocks, and each piece of content, text, heading, image, button, is its own block you add, arrange, and adjust. Type to write, use the plus button or a slash command to add other blocks, learn the seven or so blocks you will use most, move and change blocks freely, and set your featured image and categories in the settings sidebar before you publish. Lean on patterns and the list view as you grow more comfortable, and you can build rich, well-structured posts and pages with no code at all. It is the standard way to write in WordPress, and it is worth the five minutes of unfamiliarity, because after that, publishing on your site becomes something you do easily and often. Round out your setup with the essential plugins and a secure SSL setup, and you have everything a beginner needs to run a real WordPress site.