---
name: Subheading
category: Titles and text
keywords:
  - title bar
  - top-level
  - description
  - sub-section titles
  - titles of sub-sections
  - subsection titles
  - titles of subsections
  - card subheadings
  - card section headings
  - headings of card sections
  - card section subheadings
---

# 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

---

## 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](/components/lists/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)

<!-- usagelist -->
#### Do
- Shipping address

#### Don’t
- The package will be shipped to this address:

<!-- end -->

## Examples

### Subheading in a card

Use to structure content in a card.

```jsx
<Subheading>Accounts</Subheading>
```

---

## Related components

* To learn how a card is structured to group similar concepts and tasks together, [use the card component](/components/structure/card)
* To create a title for a card or top-level page section, [use the heading component](/components/titles-and-text/heading)