Subhead Block

Highlight a small piece of text on your page, typically right after a main heading, or at the start of a new section.


Use the subhead block to call attention to a short piece of content within your page. It is typically used at the beginning of a page/post, located just after the page/post title.

Unlike the heading block, the subhead is displayed using a normal paragraph tag (<p>), but styled a little differently to call attention to it.

You could use the subhead block once per page, or feel free to use it each time you introduce a new section. It probably makes the most sense to use a subhead block directly after a heading block.

NOTE: Once I placed a subhead on my page, I went to add another one, and I noticed it was disabled. So perhaps the subhead is only intended to be used once per page.

However, you can easily convert a paragraph into a subhead, which allows you to have multiple subheads per page.

If anyone has insight into this, please let me know so I can update the proper usage.

Now let's take a look at the limited settings for the subhead block.

Subhead Block Settings

The following settings are available when using the subhead block:

  • Bold
  • Italic
  • Strikethrough
  • Links
  • Additional CSS Class

Customize a Subhead Block

Subhead block editor settings

Bold, Italics & Strikethrough

These options were also available in the classic WordPress editor, and they can be used the same way on the subhead block in the new WordPress editor.

Gutenberg editor - bold, italic & strikethrough options

Simply click the B for bold, the I for italics, and the ABC for strikethrough.


You can choose to link your entire subhead, or only part of it.

  • Highlight the text you want to link
  • Click the link icon
  • Type or paste in your URL
  • Hit Enter

Advanced Subhead Settings

The only additional setting for subheads in the advanced settings area is an additional CSS class.

As a reminder...

Additional CSS Class

Like most block types, you can add a custom CSS class to any subhead block. You can utilize this field to write styles of your own.

  • Multiple CSS classes are permitted
  • Separate each class name with a space

Switch a Subhead to a Paragraph Block

You can only convert a subhead into one other type of block:

  • Paragraph

Converting a subhead into a paragraph will simply remove the extra styling and return your text to the default style for all paragraphs.

Learn About Other Gutenberg Blocks

Updated: February 27, 2018