Setup & site building · Guide
How to Use the WordPress Block Editor

Short answer
To use the WordPress block editor, open a post or page and add blocks for each piece of content, such as paragraphs, images and headings. Move blocks with the toolbar or List View, set their options in the sidebar, and reuse content with synced patterns. Preview the post, then click Publish.
Key takeaways
- The block editor became the default WordPress editor with WordPress 5.0 in December 2018.
- Every piece of content is a block with its own settings, from paragraphs to images and columns.
- List View shows every block on the page and makes nested layouts easy to manage.
- WordPress 6.3 renamed Reusable Blocks to Patterns, and synced patterns update everywhere they appear.
- The Command Palette opens with Cmd+K on macOS or Ctrl+K on Windows.
What is the WordPress block editor?
The block editor is the default WordPress editor, where every piece of content is a block that you can add, move and style on its own.
WordPress.org's Block Editor guide calls it the new way of publishing content in WordPress, and notes it is also called the WordPress editor or the Gutenberg editor. Blocks are the content elements you add to build layouts, for paragraphs, images, headings, lists, videos, galleries and more.
The block editor became the default editor with WordPress 5.0 in December 2018, when it replaced the classic editor. WordPress.org's Block Editor guide states that date plainly, and adds that you need the Classic Editor plugin if you still want the old editor.
Each block holds one kind of content and carries its own settings. A paragraph block holds text, an image block holds one picture, and a columns block holds other blocks side by side.
That split is what makes layouts possible without code. For the history of the project behind it, see what Gutenberg is.
How do you open the block editor?
Click “Posts”, then “Add New”, or “Pages”, then “Add New”, in your WordPress dashboard to open the block editor.
The editor opens in fullscreen mode by default, so the dashboard menus hide while you write.
The “W” icon in the top left, or your Site Icon if one is set, takes you back to the posts or pages list. WordPress prompts you to save first if you have unsaved work.
You can also open an existing post or page from “Posts”, then “All Posts”, or “Pages”, then “All Pages”. Click the title of the item you want to edit. Drafts open in the same editor, so there is no separate draft screen to learn.
If you see the classic editor instead, your site may have the Classic Editor plugin active, or your user profile may have it set. Turn the plugin off, or check with your site admin, to get the block editor back.
How do you add and arrange blocks?
Click the plus button in the top toolbar, pick a block, pattern or media item, and then drag it or use the block toolbar to move it.
Follow these steps to build a post:
- Click the plus icon in the top toolbar to open the block inserter.
- Pick a block from the list, or search for it by name.
- Type your content into the block. Pressing Enter after a paragraph creates a new paragraph block.
- Type a slash and a block name, such as “/image”, to add a block without touching the mouse.
- Use the up and down arrows in the block toolbar, or drag the block handle, to move a block.
- Use the three-dot menu on a block to duplicate, delete, group or copy it.
WordPress.org's Block Editor guide notes that you can select more than one block with “Shift+click”, and select all blocks with “Cmd+A” on macOS or “Ctrl+A” on Windows. Selecting several blocks at once lets you move or group them together.
You can also turn selected text into inline code by selecting it and pressing the back tick key. WordPress.org's Block Editor guide shows that shortcut in its how-to videos. Patterns give you ready-made block layouts, as explained in how to use block patterns.
What are the main parts of the editor screen?
The block editor workspace has three main sections: the top toolbar, the sidebar with post and block settings, and the content area.
The top toolbar holds the block inserter, Undo and Redo, the document overview, the Command Palette, Save Draft, Preview, the settings toggle, Publish and the three-dot menu. After you publish, a View Post or View Page option appears so you can open the live page in a new tab.
The sidebar has two tabs. The post or page settings tab holds the title, status, categories, tags, featured image and similar options. The block settings tab shows the settings for the block you have selected, such as text size, colors and spacing.
The content area is where you write. Click once to place your cursor in a block, then use the block toolbar above it to change alignment, style or options.
You can pin the block toolbar to the top of the editor with the “Top toolbar” option in the three-dot menu.
By default you work in the Visual editor, which shows your content close to how visitors will see it. Switch to the Code editor from the three-dot menu to see the whole post as HTML.
The Code editor is useful when a block misbehaves and you want to check its markup.
How do you use List View and the document outline?
Open the document overview in the top toolbar and pick List View to see every block on the page, or Outline to see word counts and headings.
List View shows a list of all the blocks on your post or page, so you can jump to any block and see how the page is nested. WordPress.org's Block Editor guide recommends it for moving and removing blocks in a complex layout.
The Outline tab shows the post or page details: character and word count, estimated time to read, and the number of paragraphs and blocks. It also shows the document outline with your headings and how they are structured.
That outline is the fastest way to spot a missing heading level or a post with no headings at all.
Use List View when a page has many nested blocks, such as columns inside groups inside a cover block. Click a block in the list to select it, then drag it to a new spot to move it.
That is far quicker than dragging blocks through a long page.
How do you reuse content with patterns?
Turn a block or a group of blocks into a pattern, then insert that pattern anywhere you need the same content again.
WordPress 6.3 renamed Reusable Blocks to Patterns, and WordPress.org's Block Patterns guide explains the change. With the Sync option on, a synced pattern behaves exactly like the old reusable block: editing it updates it everywhere it is used.
Follow these steps to make a synced pattern:
- Select the block or blocks you want to reuse.
- Click the three-dot menu in the block toolbar.
- Click “Create pattern”.
- Enter a name for the pattern.
- Turn on the Sync option.
- Click “Create”.
You can find your patterns in the inserter under the Patterns tab or the Synced Patterns tab. To change one page only, insert the pattern and pick “Detach pattern” so that copy stops following the original.
WordPress.org's Block Patterns guide notes that you can rename, duplicate, export as JSON and delete a pattern from its actions menu.
Synced patterns suit content that must match everywhere, such as a call to action at the end of every post. Unsynced patterns suit starting layouts you plan to change on each page. See how to create reusable blocks and synced patterns for the full workflow.
Which keyboard shortcuts save the most time?
Open the Command Palette with “Cmd+K” on macOS or “Ctrl+K” on Windows, and learn the shortcut list from the three-dot menu, to move faster in the editor.
The Command Palette gives you one place to work on your site design, open content and run actions such as creating a new post or page. WordPress.org's Block Editor guide says you can click the field or press “Cmd+K” on Mac or “Ctrl+K” on Windows to open it.
These shortcuts cover most daily editing:
| Shortcut | What it does |
|---|---|
| Cmd+S or Ctrl+S | Save a draft of the post or page |
| Cmd+Z or Ctrl+Z | Undo the last action |
| Cmd+Shift+Z or Ctrl+Shift+Z | Redo an undone action |
| Cmd+A or Ctrl+A | Select all blocks on the page |
| Shift+click | Select more than one block at a time |
| Back tick key | Turn selected text into inline code |
| Shift+Alt+O | Open the block list view |
| Ctrl+Shift+D or Cmd+Shift+D | Duplicate the selected block |
| Ctrl+G or Cmd+G | Create a group block from selected blocks |
The three-dot menu also lists the full shortcut set under keyboard shortcuts. Learn five shortcuts and use them for a week before you learn five more, since a small set you use daily beats a long list you never open.
How do you preview and publish a post?
Click “Preview” in the top toolbar to check the post, then click “Publish” and confirm the settings in the panel that appears.
The Preview button shows how your post or page looks on your site with the current changes applied. Check the desktop, tablet and phone views, since a layout that fits a wide screen can crowd a phone screen.
WordPress.org's Block Editor guide links its own guide on the Preview feature for the details.
Before you publish, check the sidebar: the title, the URL slug, the categories and tags, and the featured image. The Publish button sits in the top right, and after you click it a panel asks you to confirm visibility, timing and similar settings.
After publishing, the “Save Draft” label disappears and a “View Post” or “View Page” option appears. Click it to open the live page in a new tab and read it once as a visitor would.
Fix any spacing or image issue you spot there, since the editor view and the live page can differ slightly by theme.
How does the block editor differ from the classic editor?
The block editor builds a page from separate blocks with their own settings, while the classic editor gave you one large text box with a formatting toolbar.
That difference shapes how you work. In the classic editor, a picture sat inside the text flow and you styled it with the toolbar.
In the block editor, an image block has its own alignment, size, caption and link settings, and you can move it without touching the text around it.
WordPress.org's Block Editor guide states that the classic editor needs its own plugin now, since the block editor replaced it as the default in WordPress 5.0 in December 2018. The plugin keeps the old editor available for sites that need it.
Page builders add another option. Some sites use Elementor or a similar builder instead of the block editor, but that choice has trade-offs in speed and lock-in. See Gutenberg vs Elementor for a side-by-side look before you switch.
The editor is built in the open. The Block Editor Handbook notes the Gutenberg project uses GitHub to manage code and track issues.
What mistakes should you avoid?
Avoid pasting text from another app without cleaning it up, and avoid adding a new block for every line instead of letting paragraphs flow.
Watch out for these common mistakes:
- Pasting from a word processor and bringing hidden formatting with it. Paste as plain text, then format with blocks.
- Using a Heading block for text that should be a paragraph. Headings shape your document outline, so keep them for real section titles.
- Adding too many blocks to one page. A page with 40 blocks is hard to manage, so group related blocks and use List View to keep track.
- Forgetting to set a featured image, categories and tags before you publish. Those live in the sidebar, not in the content area.
- Editing in the Code editor when you meant to use the Visual editor. The Code editor shows raw HTML, so a stray keystroke there can break a block.
If you want to build your own blocks, read how to create a custom block before you start, since a custom block needs code and a build step.
Frequently asked questions
How do I add a block in the WordPress block editor?
Click the plus button in the top toolbar to open the block inserter, then pick a block, pattern or media item. You can also type a slash and a block name, such as /image, to add a block without touching the mouse. Pressing Enter after a paragraph creates a new paragraph block.
What is the difference between a pattern and a synced pattern?
A pattern is a ready-made group of blocks you insert and then change on that page. A synced pattern stays linked to the original, so editing it updates it everywhere it is used. Pick Detach pattern after inserting if you want to change one copy only.
Can I still use the classic editor in WordPress?
Yes, but you need the Classic Editor plugin, since the block editor replaced it as the default in WordPress 5.0 in December 2018. The plugin keeps the old editor available for sites that need it, though new features are built for the block editor.
How do I select more than one block at a time?
Hold Shift and click each block you want, or press Cmd+A on macOS or Ctrl+A on Windows to select all blocks on the page. You can then move, group or delete the selected blocks together, which is faster than handling each one alone.
Where are the keyboard shortcuts listed in the block editor?
Open the three-dot menu in the top toolbar and pick keyboard shortcuts to see the full list. WordPress.org also publishes a shortcuts guide that covers global, selection, block and text formatting shortcuts for Windows and Mac.
Sources
- WordPress Block Editor WordPress.org
- Block Patterns WordPress.org
- Use keyboard shortcuts (Block Editor) WordPress.org
- Intro to Block Patterns Learn WordPress
- Block themes, a new way to build themes in WordPress 5.9 Make WordPress Core
- Code Contributions - Block Editor Handbook WordPress Developer Resources
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


