Setup & site building · Explainer
What Is a WordPress Heading Block? Explained

Short answer
The Heading block is a core WordPress block that adds a title or subheading, from H1 to H6, inside a post, page or template. You pick the level in the toolbar, style it in the sidebar and can give it an HTML anchor so readers can link straight to that section.
Key takeaways
- The Heading block outputs a real HTML heading from H1 to H6.
- Type ## and a space to add an H2 heading quickly.
- Choose levels for structure and change font size for looks.
- The HTML anchor field lets you link directly to a section.
- Global styles or theme.json style every heading at once.
What is the WordPress Heading block?
The Heading block is the block in the WordPress editor that adds a title or subheading, from H1 to H6, to a post, page or template.
It is one of the core blocks that ships with WordPress, alongside Paragraph, Image and List. Each heading you add is its own block, so you can move it, style it or turn it into something else without touching the text around it.
Under the hood, the block outputs a normal HTML heading element, such as h2 or h3. That matters because browsers, screen readers and search engines read those elements to understand how your content is organised. The MDN reference for heading elements explains how h1 to h6 work in HTML.
If you are new to blocks in general, our guide on what the WordPress block editor is covers the basics first.
How do you add a Heading block?
Click the plus icon and choose Heading, type a slash and the word heading, or start a new line with one or more hash signs and a space.
There are several quick ways to insert one:
- Block inserter. Click the plus (+) button and pick Heading from the Text group.
- Slash command. On an empty line, type /heading and press Enter.
- Markdown shortcut. Type ## followed by a space to get an H2, ### for an H3, and so on.
- Transform. Select an existing Paragraph block, click its block icon in the toolbar and choose Heading.
The markdown shortcut is the fastest once you get used to it. The number of hash signs sets the level, so you rarely need to touch the toolbar.
The official Heading block documentation on WordPress.org shows each of these methods with screenshots.
What do heading levels H1 to H6 mean?
Heading levels show the outline of your content: H1 is the page title, H2 marks main sections, and H3 to H6 mark smaller subsections inside them.
Think of them like a book: the book title is H1, chapters are H2, sections inside a chapter are H3, and so on. Most posts only need H2 and H3. H4 and below are useful for long reference pages.
| Level | Typical use | How often you need it |
|---|---|---|
| H1 | Page or post title | Usually added by the theme |
| H2 | Main sections | Almost every post |
| H3 | Subsections inside an H2 | Common in longer posts |
| H4 | Points inside an H3 | Long guides and docs |
| H5 and H6 | Very deep nesting | Rarely needed |
In most themes, the post title already prints as the H1. That is why the Heading block defaults to H2 when you add one inside post content.
You change the level from the block toolbar. Click the H icon with the number and pick a different level from the list.
Should you skip heading levels?
No, it is best not to skip levels, so an H3 should sit under an H2 rather than jumping straight from an H2 to an H4.
Skipping levels does not break your page, but it makes the outline confusing. Screen reader users often jump from heading to heading to scan a page, and a missing level can make them think they missed a section.
The W3C's headings tutorial recommends nesting headings by rank and avoiding skipped levels where possible.
A common mistake is choosing a heading level for its size. If you want a smaller-looking H2, change its font size in the block settings instead of switching to H4. Level is about structure, and styling is about looks.
What settings does the Heading block have?
You can change the level and alignment from the toolbar, and set color, typography, spacing and an HTML anchor from the block sidebar.
The exact options depend on your theme, because block themes can turn individual controls on or off. In a typical setup you will see:
- Toolbar: heading level, text alignment, bold, italic, link and a few more text formats.
- Color: text color, background color and sometimes link color.
- Typography: font size, and often font family, appearance, line height, letter case and letter spacing.
- Dimensions: padding and margin, if the theme allows it.
- Advanced: HTML anchor and additional CSS classes.
If a control is missing, your theme may not support it. Block themes manage these options through their theme.json file.
To change fonts site-wide rather than one heading at a time, it is better to use global styles. Our guide on how to change the font in WordPress explains where to do that.
What is the HTML anchor on a heading?
The HTML anchor is an ID you give a heading so that you can link straight to that section, for example from a table of contents.
Open the Heading block's sidebar, expand Advanced and type a short ID in the HTML anchor field, such as pricing. Use lowercase letters and hyphens, with no spaces.
You can then link to it from anywhere:
- Inside the same page, link to #pricing.
- From another page, link to the full URL followed by #pricing.
Keep anchors short and descriptive. If you rename a section later, check that any links pointing to the old anchor still work.
Anchors are handy on long guides, FAQ pages and documentation, because readers can share a link to the exact part they need.
Can you add a table of contents from your headings?
WordPress core does not include a stable table of contents block, but many plugins and some themes build one automatically from your Heading blocks.
These tools read the headings on the page, create a linked list at the top and use the anchors to jump down. This is another reason to keep heading levels tidy, because a messy outline produces a messy table of contents.
Before adding a plugin for this, check whether your theme already has the feature. Several popular themes and SEO plugins include a table of contents option.
How do headings affect SEO and readability?
Clear headings help readers scan your page and help search engines understand its topics, but they are not a ranking shortcut on their own.
Google's SEO Starter Guide suggests using headings to organise content so readers can follow it. There is no magic in a keyword-stuffed heading.
Good habits include:
- Write headings that describe the section, not vague labels like More info.
- Keep them short enough to scan.
- Use one H1 per page, usually the title.
- Put the main point near the start of the section below the heading.
For more on writing structured posts, see how to write a blog post in WordPress.
How do you style or limit Heading blocks across a site?
Use global styles or theme.json to style every heading at once, and use block styles or code if you need custom variations or fewer heading levels.
In a block theme, go to Appearance > Editor > Styles and open the typography or blocks section. You can set heading fonts and sizes for all levels or for each level separately.
Developers can go further:
- Register custom block styles, such as an underlined heading. See how to register block styles in WordPress.
- Hide heading levels you never want editors to use. The WordPress Developer Blog has a short guide on disabling heading levels in the editor.
Limiting levels is useful on client sites, where it stops editors from picking H1 or H6 just for the size.
How is the Heading block different from the Post Title block?
The Heading block holds headings you type inside your content, while the Post Title block pulls the post's title automatically, usually in templates.
In the post editor you type your title in the title field at the top, not in a Heading block. In the Site Editor, templates use the Post Title block to show that title on the front end, and you can choose its level there.
Do not add a second H1 Heading block inside your post content just to repeat the title. Start your sections with H2 instead.
What are common Heading block problems?
The usual problems are headings that look wrong because of theme styles, missing style controls, and the wrong level chosen for visual size.
Quick checks:
- Heading looks too big or small. Change the size in the block sidebar or global styles, not the level.
- No color or font options. Your theme may not enable them, so check its settings or switch to the Site Editor styles.
- Anchor link does not jump. Make sure the anchor has no spaces and matches the link exactly.
- Want to remove it. Select the block and use the options menu to delete it. Our guide on deleting a block in WordPress shows the shortcuts.
Once you know these basics, the Heading block is one of the simplest blocks to use, and it does a lot to make your pages easier to read.
Frequently asked questions
What heading level does the Heading block use by default?
Inside post or page content, the Heading block usually starts as H2, because most themes already print the post title as the H1. You can change the level from the block toolbar at any time.
Can I use more than one H1 on a page?
HTML allows it, but most guidance recommends one H1 per page, normally the title. Use H2 for main sections inside the content so the outline stays clear for readers and assistive technology.
How do I make a heading smaller without changing its level?
Select the heading and change the font size under Typography in the block sidebar. You can also set sizes for each heading level in global styles if your theme supports it.
Why can't I see color or typography options for my heading?
Your theme controls which design tools appear. Some classic themes and some block themes turn certain options off. Check the theme settings or global styles, or ask the theme developer.
Can I convert a paragraph into a heading?
Yes. Select the paragraph, click the block type icon at the left of the toolbar and choose Heading. The text stays the same and becomes a heading at the default level.
Sources
- Heading block WordPress.org Documentation
- How to disable heading levels in the editor WordPress Developer Blog
- The HTML Section Heading elements MDN Web Docs
- Headings tutorial W3C Web Accessibility Initiative
- SEO Starter Guide Google Search Central
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.


