Codectionary / Developer documentation / HTML

<hgroup>

The <hgroup> element groups a heading with one or more subheadings or taglines, treating them as a single unit in the document outline. It is commonly used to pair a main title with a subtitle, so the subtitle does not get counted as its own separate heading level by accessibility tools.

Syntax

<hgroup>
  <h1>Main Title</h1>
  <p>Subtitle or tagline</p>
</hgroup>

Examples

Title with Subtitle

Grouping a page title with a descriptive subtitle.

<hgroup>
  <h1>Codectionary</h1>
  <p>Learn to code, one tag at a time.</p>
</hgroup>

Article Title with Byline

Using hgroup for an article heading and its byline together.

<article>
  <hgroup>
    <h2>Understanding the Event Loop</h2>
    <p>A deep dive into how JavaScript handles async code</p>
  </hgroup>
  <p>Article content...</p>
</article>

Best practices

  • Use hgroup specifically to pair a heading with a subtitle or tagline, not as a general wrapper for multiple headings
  • Keep the subtitle content as a paragraph or similar, not another heading level
  • Do not overuse hgroup — most headings do not need a subtitle wrapper
  • Test how assistive technology in your target browsers handles hgroup, since support has evolved over time

Browser compatibility

Support applies to the named feature, not every attribute or behaviour in this article. Versions refer to browsers, not operating systems.

<hgroup>

Desktop

Chrome
Supported
From 5
Firefox
Supported
From 4
Safari
Supported
From 5
Edge
Supported
From 12
Opera
Supported
From 11.1

Mobile

Safari on iOS
Supported
From 4.2
Chrome for Android
Supported
From 18
Firefox for Android
Supported
From 4
Samsung Internet
Supported
From 1.0

MDN BCD record for this feature · MDN reference

Support history and limitations

Chrome

  • From 5

Firefox

  • From 4

Safari

  • From 5

Edge

  • From 12

Opera

  • From 11.1

Safari on iOS

  • From 4.2

Chrome for Android

  • From 18

Firefox for Android

  • From 4

Samsung Internet

  • From 1.0

MDN BCD 8.1.5 · Dataset built 2026-10-08 · Mapping reviewed 2026-10-21. These dates are not individual browser-test or claim-verification dates. Unknown means the data does not establish support.

HTML Living Standard

Specifications & further reading