<hgroup>
The <hgroup>
HTML element represents a heading and related content. It groups a single <h1>–<h6>
element with one or more <p>
.
Try it
Attributes
This element only includes the global attributes.
Usage notes
The <hgroup>
element allows the grouping of a heading with any secondary content, such as subheadings, an alternative title, or tagline. Each of these types of content represented as a <p>
element within the <hgroup>
.
The <hgroup>
itself has no impact on the document outline of a web page. Rather, the single allowed heading within the <hgroup>
contributes to the document outline.
Examples
html
<!DOCTYPE html>
<title>HTML Standard</title>
<body>
<hgroup id="document-title">
<h1>HTML: Living Standard</h1>
<p>Last Updated 12 July 2022</p>
</hgroup>
<p>Some intro to the document.</p>
<h2>Table of contents</h2>
<ol id="toc">
…
</ol>
<h2>First section</h2>
<p>Some intro to the first section.</p>
</body>
Result
Accessibility concerns
The <hgroup>
presently has no strong accessibility semantics. The content of the element (a heading and optional paragraphs) is what is exposed by browser accessibility APIs.
Technical summary
Content categories | Flow content, heading content, palpable content. |
---|---|
Permitted content |
Zero or more <p> elements, followed by one
h1, h2,
h3, h4,
h5, or h6 element,
followed by zero or more <p> elements.
|
Tag omission | None, both the starting and ending tag are mandatory. |
Permitted parents | Any element that accepts flow content. |
Implicit ARIA role | No corresponding role |
Permitted ARIA roles | Any |
DOM interface | HTMLElement |
Specifications
Specification |
---|
HTML Standard # the-hgroup-element |
Browser compatibility
BCD tables only load in the browser