Skip to main contentCarbon Design System

Heading

Color

Heading text color is inherited from Carbon’s theme tokens:

ElementPropertyToken
Textcolor
$text-primary

For more on color usage, see Typography overview.

Typography

The Heading component renders semantic HTML elements (h1-h6) with default browser styling. Apply Carbon type tokens via

className
for visual styling independent of semantic level.

For detailed information on type tokens and their usage, see Type sets.

Applying type tokens

To use type token classes like

cds--type-heading-05
, ensure you’ve included the Carbon type styles in your SCSS:

@use '@carbon/type';
@include type.type-classes();

Then apply the class to your Heading component:

<Heading className="cds--type-heading-05">
Visually styled as heading-05
</Heading>

Learn more about applying type tokens in Type sets.

Productive type tokens

Fixed sizes for product interfaces:

TokenSize (px/rem)WeightLine-height (px/rem)
heading-01
14 / 0.875SemiBold / 60018 / 1.125
heading-02
16 / 1SemiBold / 60022 / 1.375
heading-03
20 / 1.25Regular / 40028 / 1.75
heading-04
28 / 1.75Regular / 40036 / 2.25
heading-05
32 / 2Regular / 40040 / 2.5
heading-06
42 / 2.625Light / 30050 / 3.125
heading-07
54 / 3.375Light / 30064 / 4

Expressive type tokens

Fluid sizes for responsive layouts:

TokenMin (px/rem)Max (px/rem)Weight
fluid-heading-03
20 / 1.2524 / 1.5Regular / 400
fluid-heading-04
28 / 1.7532 / 2Regular / 400
fluid-heading-05
32 / 240 / 2.5Regular / 400
fluid-heading-06
42 / 2.62554 / 3.375Light / 300

For more on typography layout and spacing, see Type basics.