Subheading

Subheadings are used for the title of any sub-sections in top-level page sections. Generally, sections of a card use subheadings for their titles

Examples

Use to structure content in a card.

Drag to resize example

Props

children
React.ReactNode
Text to display in subheading
element
"h1" | "h2" | "h3" | "h4" | "h5" | "h6" | "p"
The element name to use for the subheading

Accessibility

A clear and consistent heading structure helps merchants who have difficulty with reading or language. It also helps screen reader users to navigate the page using keystrokes that are custom to their screen reader.

Use the element prop to determine the specific HTML element that’s output for the subheading. The component defaults to a level 3 heading (<h3>). Use a different value for the element prop if a different subheading fits the context better.

Learn more about writing helpful headings and subheadings.

Do

Use subheadings to support the hierarchy and structure of the page.

Don’t

  • Use subheadings for style alone.
  • Use subheadings for major sections of the page.

Subheading in a card

Use to structure content in a card.

Subheading in a card

Accessibility

See Material Design and development documentation about accessibility for Android:

Subheading in a card

Use to structure content in a card.

Subheading in a card

Accessibility

See Apple’s Human Interface Guidelines and API documentation about accessibility for iOS:

Best practices

Subheadings should:

  • Be used to explain and clearly label logical groups in existing sections of a page
  • Not be used without a parent heading
  • Not be used in tables or list items, such as for the primary content in a resource list

Content guidelines

Subheadings should follow the content guidelines for headings and subheadings.