# Design System Tokens reference This consumer-facing guide explains how to choose semantic WordPress Design System tokens. For token source-file maintenance, see the [Design Tokens Maintainer's Guide](https://github.com/WordPress/gutenberg/blob/trunk/packages/theme/tokens/README.md). Design tokens are named values. They encode design decisions which describe the visual purpose of a value. Rather than referencing a raw value like `#3858e9`, a token like `--wpds-color-background-interactive-brand-strong` describes what the value is for. Tokens are delivered as CSS custom properties and consumed with `var( --wpds-* )`. ## How to pick a token Start from what you are styling and the CSS property you are setting. For example, when setting the text or icon color for an interactive control with neutral intent, choose `--wpds-color-foreground-interactive-neutral`: `foreground` for the CSS property, `interactive` for the target, and `neutral` for the tone. The raw value is an implementation detail; a token name should describe the role that value plays in the interface. Each segment of a public token name answers one question about the value being applied: - **Type** identifies the kind of value, like `color` or `dimension`. It is usually determined by the CSS property being set. - **Property** describes which aspect of the element the token applies to, such as `background`, `foreground`, `stroke`, `padding`, or `gap`. - **Target** describes the kind of element the token applies to, such as a `surface`, an `interactive` control, static `content`, or a `track`, `thumb`, or `indicator`. The standalone focus-ring color token is documented below as an exception. - **Tone** describes the semantic intent of a color, such as `neutral`, `brand`, `success`, or `error`. - **Emphasis** and **state** are modifiers that adjust strength and reflect interactive states. ## Naming pattern Semantic tokens use the `--wpds-` prefix followed by the token type and one or more role segments: ```text --wpds--[-...] ``` The most complete grammar is used by color tokens: ```text --wpds-color---[-][-] ``` Other token families use shorter forms when a segment would be redundant: | Token family | Pattern | Example | | ----------------------- | ---------------------------------------------------------------- | --------------------------------------------------------- | | Color | `--wpds-color---[-][-]` | `--wpds-color-background-interactive-brand-strong-active` | | Dimension | `--wpds-dimension--` | `--wpds-dimension-padding-lg` | | Dimension surface width | `--wpds-dimension-surface-width-` | `--wpds-dimension-surface-width-md` | | Border | `--wpds-border--` | `--wpds-border-radius-sm` | | Typography | `--wpds-typography--` | `--wpds-typography-font-size-md` | | Motion | `--wpds-motion--` | `--wpds-motion-easing-balanced` | | Cursor | `--wpds-cursor-` | `--wpds-cursor-control` | ### Type Indicates what kind of value the token represents, usually mapping to a [Design Tokens Format Module](https://www.designtokens.org/tr/2025.10/format/) token type. | Value | Description | | ------------ | ------------------------------------------------------------------------------ | | `color` | Color values for backgrounds, foregrounds, and strokes | | `dimension` | Spacing, sizing, and other measurable lengths (e.g., padding, margins, widths) | | `border` | Border properties like radius and width | | `cursor` | Cursor values for interactive affordances | | `motion` | Animation durations and easing curves | | `typography` | Typography properties like font family, font size, and line-height | ### Property The specific design property being defined. | Value | Description | | --------------- | ----------------------------------- | | `background` | Background color | | `foreground` | Foreground color (text and icons) | | `stroke` | Border and outline color | | `padding` | Internal spacing within an element | | `gap` | Spacing between elements | | `radius` | Border radius for rounded corners | | `width` | Width for the relevant token family | | `size` | Control, icon, and marker sizing | | `surface-width` | Maximum width for layout surfaces | | `duration` | Animation duration | | `easing` | Animation easing curve | | `font-size` | Font size | | `font-family` | Font family | | `font-weight` | Font weight | | `line-height` | Line height | ### Target The component or element type the token applies to. | Value | Description | | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | `surface` | Backgrounds and borders of containers, cards, panels, message bubbles, and other static layout elements. Not for clickable parts. | | `interactive` | Elements the user directly interacts with: buttons, inputs, links, checkboxes, toggles, menu items. Implies a clickable/focusable affordance. | | `content` | Static content like body text and icons. Use for foreground colors where there is no interactive behavior. | | `track` | The non-moving rail of a track-and-thumb control (scrollbar track, slider track, progressbar track). | | `thumb` | The movable handle of a track-and-thumb control (scrollbar thumb, slider handle). | | `indicator` | The filled portion of a track that represents a value (progressbar or meter fill). | | `control` | Interactive controls that are not links. | ### Modifier An optional size, intensity, state, or role modifier. | Value | Description | | ---------------------------------------------------------------------- | ------------------------------ | | `5xs`, `4xs`, `3xs`, `2xs`, `xs`, `sm`, `md`, `lg`, `xl`, `2xl`, `3xl` | Size scale modifiers | | `weak`, `strong` | Color emphasis modifiers | | `active`, `disabled` | Interactive state modifiers | | `heading`, `body`, `mono`, `default`, `emphasis` | Typography role modifiers | | `subtle`, `balanced`, `expressive` | Motion easing intent modifiers | ### Shortened and compound forms Some public tokens intentionally use shortened or compound forms: - `--wpds-dimension-surface-width-*` keeps `surface-width` together as a compound role for layout surface widths. - `--wpds-border-width-focus` uses `focus` as the target because it describes the focus indicator width, not a size on the border scale. - `--wpds-color-stroke-focus` is the standalone color-token exception described below. ## Color token modifiers Most color tokens extend the base pattern with additional modifiers for tone, emphasis, and state: ```text --wpds-color---[-][-] ``` `--wpds-color-stroke-focus` is the only color token that does not follow this target/tone grammar. Its `focus` segment describes the focus-ring purpose directly, and the token intentionally applies across tones. ### Keep color roles aligned When styling one UI element across states, keep the token role aligned and change only the state segment. For example, pair `--wpds-color-foreground-interactive-neutral` with `--wpds-color-foreground-interactive-neutral-active` and `--wpds-color-foreground-interactive-neutral-disabled` rather than switching tones between states. When styling related parts of the same UI element, prefer matching the target and tone across properties. For example, an interactive neutral control should generally use the corresponding `background`, `foreground`, and `stroke` interactive neutral tokens. Mixing tones or targets should be intentional, usually to satisfy contrast, hierarchy, or a documented component-specific pattern. ### Tone The semantic intent of the color. | Value | Description | | --------- | --------------------------------------------------------------------------------------- | | `neutral` | Neutrally toned UI elements | | `brand` | Brand-accented or primary action colors | | `success` | Positive or completed states | | `info` | Informational or system-generated context | | `caution` | Heads-up or low-severity issues; "proceed carefully" | | `warning` | Higher-severity or time-sensitive issues that require user attention but are not errors | | `error` | Blocking issues, validation failures, or destructive actions | Note: `caution` and `warning` represent two escalation levels of non-error severity. Use **`caution`** for guidance or minor risks, and **`warning`** when the user must act to prevent an error. ### Emphasis Adjusts color strength relative to the base tone. The default (no modifier) is normal emphasis. | Value | Description | | -------- | ---------------------------------------------- | | `strong` | Higher contrast and/or elevated emphasis | | `weak` | Subtle variant for secondary or muted elements | ### State The interactive state of the element. The default (no modifier) is the idle state. | Value | Description | | ---------- | ----------------------------------- | | `active` | Hovered, pressed, or selected state | | `disabled` | Unavailable or inoperable state | ## Intentional omissions The semantic token set is role-based, not a complete matrix of every property, target, tone, emphasis, and state combination. A missing combination should stay omitted when it does not map to a supported design-system role. - Do not create a token only to fill a missing slot in the naming pattern. - Add a missing state token when the same target, tone, and emphasis already define the role in other states, and a component needs that state. - Treat emphasis and tone variants as separate roles. For example, do not add strong interactive stroke variants unless a component specifically needs a distinct strong stroke role. ## Semantic tokens ### Border | Variable name | Description | | --------------------------- | ------------------------------------------------------------- | | `--wpds-border-radius-xs` | Buttons and other elements nested inside controls. | | `--wpds-border-radius-sm` | Standalone buttons, inputs, and compact controls. | | `--wpds-border-radius-md` | Menus, popovers, and other small portaled overlays. | | `--wpds-border-radius-lg` | Cards, dialogs, notices, and other larger content containers. | | `--wpds-border-radius-xl` | Page and app shell surfaces. | | `--wpds-border-width-xs` | Extra small width | | `--wpds-border-width-sm` | Small width | | `--wpds-border-width-md` | Medium width | | `--wpds-border-width-lg` | Large width | | `--wpds-border-width-focus` | Border width for focus ring | ### Color | Variable name | Description | | ------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | | `--wpds-color-background-surface-neutral` | Background color for surfaces with normal emphasis. | | `--wpds-color-background-surface-neutral-strong` | Background color for surfaces with strong emphasis. | | `--wpds-color-background-surface-neutral-weak` | Background color for surfaces with weak emphasis. | | `--wpds-color-background-surface-brand` | Background color for surfaces with brand tone and normal emphasis. | | `--wpds-color-background-surface-success` | Background color for surfaces with success tone and normal emphasis. | | `--wpds-color-background-surface-success-weak` | Background color for surfaces with success tone and weak emphasis. | | `--wpds-color-background-surface-info` | Background color for surfaces with info tone and normal emphasis. | | `--wpds-color-background-surface-info-weak` | Background color for surfaces with info tone and weak emphasis. | | `--wpds-color-background-surface-warning` | Background color for surfaces with warning tone and normal emphasis. | | `--wpds-color-background-surface-warning-weak` | Background color for surfaces with warning tone and weak emphasis. | | `--wpds-color-background-surface-caution` | Background color for surfaces with caution tone and normal emphasis. | | `--wpds-color-background-surface-caution-weak` | Background color for surfaces with caution tone and weak emphasis. | | `--wpds-color-background-surface-error` | Background color for surfaces with error tone and normal emphasis. | | `--wpds-color-background-surface-error-weak` | Background color for surfaces with error tone and weak emphasis. | | `--wpds-color-background-interactive-neutral` | Solid background color for neutral interactive controls, such as input fields and unchecked checkboxes. | | `--wpds-color-background-interactive-neutral-active` | Solid background color for neutral interactive controls that are hovered, focused, or active. | | `--wpds-color-background-interactive-neutral-disabled` | Solid background color for neutral interactive controls in their disabled state. | | `--wpds-color-background-interactive-neutral-strong` | Background color for interactive elements with neutral tone and strong emphasis. | | `--wpds-color-background-interactive-neutral-strong-active` | Background color for interactive elements with neutral tone and strong emphasis that are hovered, focused, or active. | | `--wpds-color-background-interactive-neutral-strong-disabled` | Background color for interactive elements with neutral tone and strong emphasis, in their disabled state. | | `--wpds-color-background-interactive-neutral-weak` | Background color for interactive elements with neutral tone and weak emphasis. | | `--wpds-color-background-interactive-neutral-weak-active` | Background color for interactive elements with neutral tone and weak emphasis that are hovered, focused, or active. | | `--wpds-color-background-interactive-neutral-weak-disabled` | Background color for interactive elements with neutral tone and weak emphasis, in their disabled state. | | `--wpds-color-background-interactive-brand-strong` | Background color for interactive elements with brand tone and strong emphasis. | | `--wpds-color-background-interactive-brand-strong-active` | Background color for interactive elements with brand tone and strong emphasis that are hovered, focused, or active. | | `--wpds-color-background-interactive-brand-strong-disabled` | Background color for interactive elements with brand tone and strong emphasis, in their disabled state. | | `--wpds-color-background-interactive-brand-weak` | Background color for interactive elements with brand tone and weak emphasis. | | `--wpds-color-background-interactive-brand-weak-active` | Background color for interactive elements with brand tone and weak emphasis that are hovered, focused, or active. | | `--wpds-color-background-interactive-brand-weak-disabled` | Background color for interactive elements with brand tone and weak emphasis, in their disabled state. | | `--wpds-color-background-interactive-error` | Background color for interactive elements with error tone and normal emphasis. | | `--wpds-color-background-interactive-error-active` | Background color for interactive elements with error tone and normal emphasis that are hovered, focused, or active. | | `--wpds-color-background-interactive-error-disabled` | Background color for interactive elements with error tone and normal emphasis, in their disabled state. | | `--wpds-color-background-interactive-error-strong` | Background color for interactive elements with error tone and strong emphasis. | | `--wpds-color-background-interactive-error-strong-active` | Background color for interactive elements with error tone and strong emphasis that are hovered, focused, or active. | | `--wpds-color-background-interactive-error-strong-disabled` | Background color for interactive elements with error tone and strong emphasis, in their disabled state. | | `--wpds-color-background-interactive-error-weak` | Background color for interactive elements with error tone and weak emphasis. | | `--wpds-color-background-interactive-error-weak-active` | Background color for interactive elements with error tone and weak emphasis that are hovered, focused, or active. | | `--wpds-color-background-interactive-error-weak-disabled` | Background color for interactive elements with error tone and weak emphasis, in their disabled state. | | `--wpds-color-background-track-neutral-weak` | Background color for tracks with a neutral tone and weak emphasis (eg. scrollbar track). | | `--wpds-color-background-track-neutral` | Background color for tracks with a neutral tone and normal emphasis (eg. slider, progressbar, or switch track). | | `--wpds-color-background-track-neutral-disabled` | Background color for tracks with a neutral tone and normal emphasis (eg. switch track), in their disabled state. | | `--wpds-color-background-thumb-neutral` | Background color for thumbs with a neutral tone and normal emphasis (eg. switch knob when off). | | `--wpds-color-background-thumb-neutral-disabled` | Background color for thumbs with a neutral tone and normal emphasis (eg. switch knob), in their disabled state. | | `--wpds-color-background-thumb-neutral-weak` | Background color for thumbs with a neutral tone and weak emphasis (eg. scrollbar thumb). | | `--wpds-color-background-thumb-neutral-weak-active` | Background color for thumbs with a neutral tone and weak emphasis (eg. scrollbar thumb) that are hovered, focused, or active. | | `--wpds-color-background-thumb-brand` | Background color for thumbs with a brand tone and normal emphasis (eg. slider thumb). | | `--wpds-color-background-thumb-brand-active` | Background color for thumbs with a brand tone and normal emphasis (eg. slider thumb) that are hovered, focused, or active. | | `--wpds-color-background-thumb-brand-disabled` | Background color for thumbs with a brand tone and normal emphasis (eg. slider thumb), in their disabled state. | | `--wpds-color-background-thumb-brand-strong` | Background color for thumbs with a brand tone and strong emphasis (eg. switch knob when on). | | `--wpds-color-background-thumb-neutral-weak-disabled` | Background color for thumbs with a neutral tone and weak emphasis (eg. scrollbar thumb), in their disabled state. | | `--wpds-color-background-indicator-neutral` | Background color for indicators with a neutral tone and normal emphasis (eg. the filled portion of a progressbar or meter). | | `--wpds-color-background-indicator-brand` | Background color for indicators with a brand tone and normal emphasis (eg. the filled portion of a meter). | | `--wpds-color-background-indicator-success` | Background color for indicators with a success tone and normal emphasis (eg. the filled portion of a meter). | | `--wpds-color-background-indicator-warning` | Background color for indicators with a warning tone and normal emphasis (eg. the filled portion of a meter). | | `--wpds-color-background-indicator-error` | Background color for indicators with an error tone and normal emphasis (eg. the filled portion of a meter). | | `--wpds-color-foreground-content-neutral` | Foreground color for content like text with normal emphasis. | | `--wpds-color-foreground-content-neutral-weak` | Foreground color for content like text with weak emphasis. | | `--wpds-color-foreground-content-success` | Foreground color for content like text with success tone and normal emphasis. | | `--wpds-color-foreground-content-success-weak` | Foreground color for content like text with success tone and weak emphasis. | | `--wpds-color-foreground-content-info` | Foreground color for content like text with info tone and normal emphasis. | | `--wpds-color-foreground-content-info-weak` | Foreground color for content like text with info tone and weak emphasis. | | `--wpds-color-foreground-content-warning` | Foreground color for content like text with warning tone and normal emphasis. | | `--wpds-color-foreground-content-warning-weak` | Foreground color for content like text with warning tone and weak emphasis. | | `--wpds-color-foreground-content-caution` | Foreground color for content like text with caution tone and normal emphasis. | | `--wpds-color-foreground-content-caution-weak` | Foreground color for content like text with caution tone and weak emphasis. | | `--wpds-color-foreground-content-error` | Foreground color for content like text with error tone and normal emphasis. | | `--wpds-color-foreground-content-error-weak` | Foreground color for content like text with error tone and weak emphasis. | | `--wpds-color-foreground-interactive-neutral` | Foreground color for interactive elements with neutral tone and normal emphasis. | | `--wpds-color-foreground-interactive-neutral-active` | Foreground color for interactive elements with neutral tone and normal emphasis that are hovered, focused, or active. | | `--wpds-color-foreground-interactive-neutral-disabled` | Foreground color for interactive elements with neutral tone and normal emphasis, in their disabled state. | | `--wpds-color-foreground-interactive-neutral-strong` | Foreground color for interactive elements with neutral tone and strong emphasis. | | `--wpds-color-foreground-interactive-neutral-strong-active` | Foreground color for interactive elements with neutral tone and strong emphasis that are hovered, focused, or active. | | `--wpds-color-foreground-interactive-neutral-strong-disabled` | Foreground color for interactive elements with neutral tone and strong emphasis, in their disabled state. | | `--wpds-color-foreground-interactive-neutral-weak` | Foreground color for interactive elements with neutral tone and weak emphasis. | | `--wpds-color-foreground-interactive-neutral-weak-active` | Foreground color for interactive elements with neutral tone and weak emphasis that are hovered, focused, or active. | | `--wpds-color-foreground-interactive-neutral-weak-disabled` | Foreground color for interactive elements with neutral tone and weak emphasis, in their disabled state. | | `--wpds-color-foreground-interactive-brand` | Foreground color for interactive elements with brand tone and normal emphasis. | | `--wpds-color-foreground-interactive-brand-active` | Foreground color for interactive elements with brand tone and normal emphasis that are hovered, focused, or active. | | `--wpds-color-foreground-interactive-brand-disabled` | Foreground color for interactive elements with brand tone and normal emphasis, in their disabled state. | | `--wpds-color-foreground-interactive-brand-strong` | Foreground color for interactive elements with brand tone and strong emphasis. | | `--wpds-color-foreground-interactive-brand-strong-active` | Foreground color for interactive elements with brand tone and strong emphasis that are hovered, focused, or active. | | `--wpds-color-foreground-interactive-brand-strong-disabled` | Foreground color for interactive elements with brand tone and strong emphasis, in their disabled state. | | `--wpds-color-foreground-interactive-error` | Foreground color for interactive elements with error tone and normal emphasis. | | `--wpds-color-foreground-interactive-error-active` | Foreground color for interactive elements with error tone and normal emphasis that are hovered, focused, or active. | | `--wpds-color-foreground-interactive-error-disabled` | Foreground color for interactive elements with error tone and normal emphasis, in their disabled state. | | `--wpds-color-foreground-interactive-error-strong` | Foreground color for interactive elements with error tone and strong emphasis. | | `--wpds-color-foreground-interactive-error-strong-active` | Foreground color for interactive elements with error tone and strong emphasis that are hovered, focused, or active. | | `--wpds-color-foreground-interactive-error-strong-disabled` | Foreground color for interactive elements with error tone and strong emphasis, in their disabled state. | | `--wpds-color-stroke-surface-neutral` | Decorative stroke color used to define neutrally-toned surface boundaries with normal emphasis. | | `--wpds-color-stroke-surface-neutral-weak` | Decorative stroke color used to define neutrally-toned surface boundaries with weak emphasis. | | `--wpds-color-stroke-surface-neutral-strong` | Decorative stroke color used to define neutrally-toned surface boundaries with strong emphasis. | | `--wpds-color-stroke-surface-brand` | Decorative stroke color used to define brand-toned surface boundaries with normal emphasis. | | `--wpds-color-stroke-surface-brand-strong` | Decorative stroke color used to define brand-toned surface boundaries with strong emphasis. | | `--wpds-color-stroke-surface-success` | Decorative stroke color used to define success-toned surface boundaries with normal emphasis. | | `--wpds-color-stroke-surface-success-strong` | Decorative stroke color used to define success-toned surface boundaries with strong emphasis. | | `--wpds-color-stroke-surface-info` | Decorative stroke color used to define info-toned surface boundaries with normal emphasis. | | `--wpds-color-stroke-surface-info-strong` | Decorative stroke color used to define info-toned surface boundaries with strong emphasis. | | `--wpds-color-stroke-surface-warning` | Decorative stroke color used to define warning-toned surface boundaries with normal emphasis. | | `--wpds-color-stroke-surface-warning-strong` | Decorative stroke color used to define warning-toned surface boundaries with strong emphasis. | | `--wpds-color-stroke-surface-caution` | Decorative stroke color used to define caution-toned surface boundaries with normal emphasis. | | `--wpds-color-stroke-surface-caution-strong` | Decorative stroke color used to define caution-toned surface boundaries with strong emphasis. | | `--wpds-color-stroke-surface-error` | Decorative stroke color used to define error-toned surface boundaries with normal emphasis. | | `--wpds-color-stroke-surface-error-strong` | Decorative stroke color used to define error-toned surface boundaries with strong emphasis. | | `--wpds-color-stroke-interactive-neutral` | Accessible stroke color used for interactive neutrally-toned elements with normal emphasis. | | `--wpds-color-stroke-interactive-neutral-active` | Accessible stroke color used for interactive neutrally-toned elements with normal emphasis that are hovered, focused, or active. | | `--wpds-color-stroke-interactive-neutral-disabled` | Accessible stroke color used for interactive neutrally-toned elements with normal emphasis, in their disabled state. | | `--wpds-color-stroke-interactive-neutral-strong` | Accessible stroke color used for interactive neutrally-toned elements with strong emphasis. | | `--wpds-color-stroke-interactive-brand` | Accessible stroke color used for interactive brand-toned elements with normal emphasis. | | `--wpds-color-stroke-interactive-brand-active` | Accessible stroke color used for interactive brand-toned elements with normal emphasis that are hovered, focused, or active. | | `--wpds-color-stroke-interactive-brand-disabled` | Accessible stroke color used for interactive brand-toned elements with normal emphasis, in their disabled state. | | `--wpds-color-stroke-interactive-error` | Accessible stroke color used for interactive error-toned elements with normal emphasis. | | `--wpds-color-stroke-interactive-error-active` | Accessible stroke color used for interactive error-toned elements with normal emphasis that are hovered, focused, or active. | | `--wpds-color-stroke-interactive-error-disabled` | Accessible stroke color used for interactive error-toned elements with normal emphasis, in their disabled state. | | `--wpds-color-stroke-interactive-error-strong` | Accessible stroke color used for interactive error-toned elements with strong emphasis. | | `--wpds-color-stroke-focus` | Accessible stroke color applied to focus rings. | ### Cursor | Variable name | Description | | ----------------------- | ------------------------------------------------------------------------------------------------- | | `--wpds-cursor-control` | Cursor style for interactive controls that are not links (e.g. buttons, checkboxes, and toggles). | ### Dimension | Variable name | Description | | ------------------------------------ | ------------------------------------------------------------------------ | | `--wpds-dimension-padding-xs` | Extra small padding | | `--wpds-dimension-padding-sm` | Small padding | | `--wpds-dimension-padding-md` | Medium padding | | `--wpds-dimension-padding-lg` | Large padding | | `--wpds-dimension-padding-xl` | Extra large padding | | `--wpds-dimension-padding-2xl` | 2x extra large padding | | `--wpds-dimension-padding-3xl` | 3x extra large padding | | `--wpds-dimension-gap-xs` | Extra small gap | | `--wpds-dimension-gap-sm` | Small gap | | `--wpds-dimension-gap-md` | Medium gap | | `--wpds-dimension-gap-lg` | Large gap | | `--wpds-dimension-gap-xl` | Extra large gap | | `--wpds-dimension-gap-2xl` | 2x extra large gap | | `--wpds-dimension-gap-3xl` | 3x extra large gap | | `--wpds-dimension-size-5xs` | Notification indicators | | `--wpds-dimension-size-4xs` | Visual size for small interactive elements like resize handles | | `--wpds-dimension-size-3xs` | Small markers | | `--wpds-dimension-size-2xs` | For small controls like checkboxes and radios, or small decorative icons | | `--wpds-dimension-size-xs` | For medium sized icons | | `--wpds-dimension-size-sm` | For icons and small buttons | | `--wpds-dimension-size-md` | For medium-sized buttons and inputs | | `--wpds-dimension-size-lg` | Default size for buttons and inputs | | `--wpds-dimension-surface-width-xs` | Extra small surface width | | `--wpds-dimension-surface-width-sm` | Small surface width | | `--wpds-dimension-surface-width-md` | Medium surface width | | `--wpds-dimension-surface-width-lg` | Large surface width | | `--wpds-dimension-surface-width-xl` | Extra large surface width | | `--wpds-dimension-surface-width-2xl` | 2x extra large surface width | ### Motion | Variable name | Description | | --------------------------------- | --------------------------------------------------------------------------------------------------- | | `--wpds-motion-duration-xs` | Micro-delays and transition offsets | | `--wpds-motion-duration-sm` | Micro-interactions like focus rings and state changes | | `--wpds-motion-duration-md` | Standard transitions like menus and popovers | | `--wpds-motion-duration-lg` | Deliberate animations like slides and reveals | | `--wpds-motion-duration-xl` | Extended animations like complex or multi-step transitions | | `--wpds-motion-easing-subtle` | Nearly imperceptible easing for hover, color, and background transitions | | `--wpds-motion-easing-balanced` | General-purpose easing for on-screen movement like resizing, morphing, and layout shifts | | `--wpds-motion-easing-expressive` | Noticeable easing for enter/exit and spatial transitions like menus, popovers, dialogs, and drawers | ### Typography | Variable name | Description | | ---------------------------------------- | ------------------------------------------------------- | | `--wpds-typography-font-family-heading` | Headings font family | | `--wpds-typography-font-family-body` | Body font family | | `--wpds-typography-font-family-mono` | Monospace font family | | `--wpds-typography-font-size-xs` | Extra small font size | | `--wpds-typography-font-size-sm` | Small font size | | `--wpds-typography-font-size-md` | Medium font size | | `--wpds-typography-font-size-lg` | Large font size | | `--wpds-typography-font-size-xl` | Extra large font size | | `--wpds-typography-font-size-2xl` | 2X large font size | | `--wpds-typography-line-height-xs` | Extra small line height | | `--wpds-typography-line-height-sm` | Small line height | | `--wpds-typography-line-height-md` | Medium line height | | `--wpds-typography-line-height-lg` | Large line height | | `--wpds-typography-line-height-xl` | Extra large line height | | `--wpds-typography-line-height-2xl` | 2X large line height | | `--wpds-typography-font-weight-default` | Baseline text weight for body copy and UI text | | `--wpds-typography-font-weight-emphasis` | Elevated text weight for labels, controls, and headings |