This is a heading.
This is a subheading!
Overview
The subheading element makes text look like a muted heading. It’s great to pair with a heading, but is usually unnecessary when followed by body text.
It makes the text larger (xl
) and applies a slightly muted color depending on tone.
Considerations
Spacing — Unless used inside a content element, the subheading element defines no margin. That means that you’ll need to manually position it inside your layout.
Variants
The subheading has full contextual tone and priority support.
Accessibility
Don't use color to communicate. Instead, use color to support information you communicate through text. When this isn't possible, be sure to use a title
attribute.
Be mindful of contrast. What looks good to you may not be readable for others. Text contrast is a good thing!
Support all navigation modes. Some people will interact with your interface using assitive technologies and/or a keyboard. Build your interface with these different modes in mind (for example, by setting the `tab-index` attribute on all interactive elements that aren't interactive by default).
Examples
I'm a little subheading. I'm honestly pretty rare.
Example code
<p class="subheading">I'm a little subheading. I'm honestly pretty rare.</p>