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
<Subheading>Accounts</Subheading>
Name
Type
Description
element
string
The element name to use for the subheading
children
string
Text to display in subheading

Purpose

Put the merchant first by identifying the problem they face and the component that helps them solve it.

Problem

Merchants want to find a particular piece of content quickly.

Solution

Subheadings provide visual wayfinding cues in a card or page section so merchants can scan to understand what’s most relevant to them.


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 be:

  • Informative and descriptive: they should label the type of content grouped beneath them
  • Concise and scannable:
    • Use simple, clear language that can be read at a glance
    • Keep subheadings to single sentence and avoid using punctuation such as periods, commas, or semicolons
    • Write in sentence case (first word capitalized, the rest lowercase)
  • Shipping address

  • The package will be shipped to this address: