The block editor: building pages with blocks
Learn to build pages with the block editor: adding blocks, headings, images, links, patterns and revisions, with a real look at how blocks are stored.
In this lesson you will
- Add and arrange blocks
- Use headings correctly
- Add links and images
- Use patterns and revisions
About 15 minutes
Writing with blocks
Hassan opens a new page and sees an empty white space with a blinking cursor and a small plus sign. He expects a Word-like toolbar. Instead, WordPress asks him to ‘Type / to choose a block’. This is the block editor, also called Gutenberg. Every paragraph, heading, image, list and button is a separate block, like a brick, and you build a page by stacking and arranging bricks. Once the idea clicks, it is fast and flexible.
The screen
| Area | What it does |
|---|---|
| Top bar | Add block (+), undo and redo, list view, Preview, Save, Publish |
| Canvas (the middle) | Where you write and see the page |
| Right sidebar | Settings for the page and for the selected block |
| Block toolbar | A small bar above the selected block: bold, link, align, move |
Adding blocks
- Press Enter to start a new paragraph block.
- Type / and a word, such as /image or /heading, then press Enter to insert it.
- Click the + button to browse blocks by category.
- Drag blocks by their handle, or use the up and down arrows on the toolbar, to reorder.
The blocks you will use every day
| Block | Use it for |
|---|---|
| Paragraph | Normal text |
| Heading | Titles and section headings (levels 2 to 4) |
| Image, Gallery | Pictures |
| List | Bulleted or numbered lists |
| Quote | Quotations or testimonials |
| Buttons | Calls to action such as ‘Order now’ |
| Columns, Group | Layout: side-by-side content and boxes |
| Spacer, Separator | Space and divider lines |
Blocks are just saved markup
Behind the screen, WordPress saves the page as ordinary HTML with special comments that mark where each block starts and ends. A test site was given a small piece of that saved format and asked which blocks it found. It was also asked to save a post, edit it three times and count the revisions it kept. The output is real:
Blocks found:
core/heading (level 2)
core/paragraph
core/list
core/quote
core/buttons
Revisions saved after 3 edits: 3
Each block has a name such as core/heading, and settings such as the heading level are stored with it. That is why blocks are so portable: plain, structured pieces that any theme can restyle. The revision count shows a safety net: WordPress keeps older versions of your content, so you can compare and restore a previous one from the sidebar if you make a mistake. The exact number it keeps can differ by site settings.
Headings the right way
Use the Heading block, not bold paragraph text, for section titles. Headings give your page an outline for search engines and screen readers. Your page title is the main heading (H1), so use H2 for main sections and H3 for sub-sections underneath. Do not skip levels just to get a bigger font; change the size in the block settings instead.
Links, images and formatting
- Select text, click the link icon (or press Ctrl+K), type or paste an address, press Enter.
- Add an image block, then upload or choose from the library. Fill in the alt text in the sidebar.
- Use Ctrl+B and Ctrl+I for bold and italic, sparingly.
- Use Ctrl+Z to undo, and the List View to see the page’s structure.
Patterns and reusable blocks
A pattern is a saved arrangement of blocks, such as a call-to-action box or a team section. Themes ship with patterns, and you can save your own. Insert one from the + menu under Patterns, then change the words. For things you reuse and want to update everywhere at once, such as a footer notice, save a synced pattern. Names and menus for these have changed across versions, so look for ‘Patterns’ in the inserter.
Before you publish
- Click Preview and check on a phone-sized view as well.
- Read it aloud once. You will hear mistakes your eyes skip.
- Check every link and every image’s alt text.
- Set the category, tags and featured image.
- Then publish, or schedule it.
Practice
Create a page called ‘About me’ with a heading, two paragraphs, a list of three things you enjoy, an image with alt text, a quote and a button linking to your contact page. Use the / shortcut at least four times. Make one deliberate edit, then open the revisions and restore the earlier version.
If /image does nothing, you may be inside a different block’s text; press Enter to start a new line first. To restore a revision, open the sidebar under Post or Page, click Revisions and use the slider to compare and restore.
Making headings by selecting normal text and making it big and bold. It looks right but has no structure. Use real Heading blocks so search engines and screen readers understand the page.
Keyboard shortcuts worth learning
| Keys | What they do |
|---|---|
| Ctrl+Z / Ctrl+Y | Undo and redo |
| Ctrl+K | Add or edit a link |
| Ctrl+B / Ctrl+I | Bold and italic |
| Ctrl+S | Save a draft |
| Enter, then / | New block and block search |
On a Mac, use the Command key in place of Ctrl. These few shortcuts remove most of the mouse travelling and make writing in the editor feel as quick as a word processor.
Check what you learned
Five quick questions. Pick an answer and you will see straight away whether it is right and why.
What is a block?
- A website ban
- A theme
- One piece of content such as a paragraph or image
- A user role
Pages are built by stacking blocks.
How do you quickly insert a block while typing?
- Press F12
- Close the page
- Reboot
- Type / and its name
For example /image or /heading.
Which heading level should main sections inside a page use?
- H1 every time
- H2
- No heading
- H6
The page title is H1.
Why are revisions useful?
- They speed up the site
- They add images
- You can restore an earlier version
- They delete drafts
They are a safety net.
What is a pattern?
- A saved arrangement of blocks
- A password
- A plugin
- A font
Insert it and change the words.
Summary
- Everything is a block: insert with + or /.
- Use real Heading blocks, H2 and H3 under the page title.
- Preview, check links and alt text, then publish.
- Revisions let you go back.
Questions
What if I prefer the old editor?
Some sites keep a Classic Editor plugin, but the block editor is the standard and gets the new features. Learn blocks first.
Why does my page look different on the live site?
The editor shows an approximation. Always use Preview, and check your theme's styles.
Can I copy text from Word?
Yes. Paste into a paragraph block, then check headings and lists. Remove stray formatting with the clear-formatting option.
