Skip to main content
Styles

Heading

Use headings to structure content on pages.

Read the Design System guidance for heading

Import

import { Heading } from 'govuk-react/heading';

Examples

Default

Code
<Heading size="l">
  Heading text
</Heading>

Level aliases

Code
<>
  <Heading size="xl" headingLevel={1}>
    H1
  </Heading>
  <Heading size="l">H2</Heading>
  <Heading size="m" headingLevel={3}>
    H3
  </Heading>
  <Heading size="s" headingLevel={4}>
    H4
  </Heading>
  <Heading size="s" headingLevel={5}>
    H5
  </Heading>
  <Heading size="s" headingLevel={6}>
    H6
  </Heading>
</>

Differing sizes

Code
<>
  <Heading size="xl" headingLevel={6}>
    h6 with xl size
  </Heading>
  <Heading size="s">h2 with s size</Heading>
  <Heading size="l" headingLevel={3}>
    h3 with l size
  </Heading>
</>

Props pass through

Code
<Heading
  size="xl"
  id="heading-id"
>
  Click me
</Heading>

API reference

Heading

Use headings to structure content on pages.

PropType
sizeRequired"s" | "xl" | "l" | "m"
headingLevel1 | 2 | 3 | 4 | 5 | 6
marginBottomSpacing