Skip to content
TrademarkTrademark
Docs
Components

Heading

Updated: October 18, 2026
View on GitHub

Heading is Text set to heading-strong-l, with accessibilityRole="header" so screen readers announce it as a header and let people jump between headings. It takes the same props as Text. See the web Heading page for the full set of variants.

Variants

Pick the size with variant. Any heading or display variant works.

Colors and spacing

onBackground, onSolid, align, truncate and the spacing props work as on Text.

Differences from the web

  • No as. There are no h1 to h6 elements. Every Heading is a header to screen readers, and the variant sets its size.
  • Use variant. Heading always passes a variant, so family, size and weight alone do not change it.

Props

Heading takes every Text prop, the spacing props and every React Native Text prop.

Prop
Type
Default
Description
variantTextVariant"heading-strong-l"The type style.
onBackground"<scheme>-<weight>""neutral-strong"Text colour on a background.
onSolid"<scheme>-<weight>"Text colour on a solid surface. Wins over onBackground.
align"left" | "center" | "right" | "justify"Text alignment.
truncatebooleanOne line, ending in an ellipsis.
styleTextStyle | TextStyle[]Applied after the props.
Edit this page on GitHub