Version 6.0.0


Heading is a typography component used to create various levels of hierarchies between text.


Key example of heading classifications Serif and Sans serif.


Headings can be displayed in serif or sans serif (default).

Key example of heading weights. Text with font weights Light, Default, and Heavy


Heading weight is another way to create or enhance visual hierarchy, in addition to size. Heavier and lighter weights can add personality or style to an experience.

List of size options for heading text. Extra-extra-extra-large is font-size-1300. Extra-extra-large is font-size-1100. Extra-large is font-size 900. Large is font-size-700. Medium is font-size-500. Small is font-size-300. Extra-small is font-size-200. Extra-extra-small is font-size-100.


Headings have a variety of sizes available. These sizes are defined using T-shirt sizing in order to support multiple scales without direct correlation to pixel values.

Table of options#

From the design point of view, each component has a number of options. These options and their names are platform agnostic, and each implementation should adapt these to fit into their framework.

PropertyValuesDefault value
scriptlatin / han / arabic / hebrew
classificationserif / sans serifsans serif
weightlight / default / heavydefault
sizeXXS / XS / S / M / L / XS / XXL / XXXLM (content-based UI)
S (application UI)



Line height#

Headings use a 1.3× multiplier for Latin, Arabic, and Hebrew scripts. Han scripts (Simplified Chinese, Traditional Chinese, Japanese, and Korean) use a 1.5× multiplier to ensure readability. This applies to all Spectrum fonts as well as their fallback fonts.



Top margins are the heading font size divided by 1.125. Bottom margins are 0.25× the heading font size.

Usage guidelines#

Define appropriate heading levels#

Headings can be assigned a heading level in HTML that is independent of typography component, size, weight, or other properties.

Key example illustrating correct usage of defining heading levels. Heading text 'welcome' with heading level h1 and subheading 'introduction' with heading level h2.


Dec 03, 20196.0.0
  • Released as individually versioned component
  • Added options for script, weight and classification
  • Updated to use t-shirt sizing
  • Added larger size options

Design checklist#


All interactive states

Includes all interactive states that are applicable (hover, down, focus, keyboard focus, disabled).

Multiple options

Includes relevant options (variant, style, size, orientation, optional iconography, decorations, selection, error state, etc.)

All color themes

Works properly across all four color themes (lightest, light, dark, darkest).

All platform scales

Includes a desktop scale (UWP, macOS, web desktop) and a mobile scale (iOS, Android, web mobile).

Defined behaviors

Includes guidelines for layout (wrapping, truncation, overflow), animation, interactions, etc.

Usage guidelines

Includes a list of dos and don’ts that highlight best practices and common mistakes.

Accessible contrast

Follows WCAG 2.0 standards for contrast (AA).


Internationalization guidelines

Works properly across various locales and includes guidelines for bi-directionality (RTL).


Keyboard interactions

Follows WCAG 2.0 standards for keyboard accessibility guidelines and includes a description of the keyboard interactions.

Design tokens

All design attributes (color, typography, layout, animation, etc.) are included in Spectrum DNA.

Generated UI kit

Includes a downloadable XD file that has been generated by code and shows multiple variations, states, color themes, and scales.

In Spectrum for Adobe XD plugin

Component is included in the Spectrum for Adobe XD plugin.