Add a page title (H1) to every page

  • seo
  • headings
  • hero
  • page-editing

Updated

Every page should have one visible H1 heading near the top that says what the page is about. In the WordPress block editor, add a Heading block and set it to H1, or add a Title block (called Post Title in older versions) and set its level to H1 in the block toolbar, since it starts as H2. Whether your theme also shows the page's title on its own depends on the theme, so check the live page. Many themes print the title as an H1 for you, and adding another H1 then gives the page two.

On a Dirigible site, pages and posts handle this differently.

Pages: add the H1 yourself

A page shows only the blocks you add. Nothing adds a title for you, so put an H1 at the top with one of these:

  • A Hero block, whose headline is an H1 by default.
  • A Title block (Post Title in older versions) set to H1.
  • A Heading block set to H1.
  • A Columns layout with an H1 heading next to an image.

The title field at the top of the editor names the page in the dashboard and menus and sets its web address. It doesn't show on the page unless you add a Title block.

Posts: a title is added when you need one

If a post doesn't start with a Hero, Hero Slider, Slider, or Title block, Dirigible adds a title section at the top that shows the post title as an H1 and the featured image, if the post has one.

Start the post with a Hero, Hero Slider, Slider, or Title block and Dirigible leaves the top to you.

To turn the automatic title off for one post, open the Display box in the Post sidebar and set Post Title to Hide. Then add your own H1, or the post has none.

Check which heading is the H1

The surest check is the live page:

  1. Open the page and right-click its main headline.
  2. Choose Inspect. The highlighted code starts with <h1 if it's the H1.
  3. To count them, view the page source (Ctrl+U, or Option+⌘+U in Chrome on a Mac) and search for <h1. You want exactly one.

In the editor, click Document Overview (the list icon in the top toolbar) and open the Outline tab. It lists your Heading blocks by level, but not headlines inside other blocks such as a Hero. It can also flag an H1 Heading block with "(Your theme may already use a H1 for the post title)". Dirigible doesn't add a title to pages, so on a page you can ignore that note.

Fix two H1s

Two H1s usually means the theme printed the title as an H1 and the page also has an H1 block, or two blocks are both set to H1. Keep the one at the top and change the other:

  • A Heading or Title block: select it and pick a lower level from Change level in the block toolbar.
  • A Hero: in its Content panel, set the headline's Tag to h2.
  • On a Dirigible post, a Heading block set to H1 below the automatic title section: make it an H2, or start the post with a Title block instead.

To make a heading look bigger without changing its level, use a style instead; see Structure a page with headings (H1, H2, H3).

Tips

  • Use one H1 per page, then H2s and H3s for the sections below it. See Structure a page with headings (H1, H2, H3).
  • Keep the H1 near the top, where visitors and search engines look first.
  • If the featured image appears in the automatic title section, set a focal point so the crop stays on the subject.

Built by Dirigible Studio. Get in touch