# Design Token

> A name for one design choice, like a brand color. Design and code share it.

**Field:** Design  
**Category:** Design Standards  
**Also known as:** Design Tokens, Style Token, Token (Design)

## Think of it like

It is like a nickname for a color. Change who the nickname points to, and every use changes.

## Definition

A design token is a named value for one design choice, like a color, a font size or a spacing step. A team does not write #2563eb in a hundred places. It writes one name for the main color instead. The token is stored once and shared by the design files and the code on every platform. Change the token, and every screen that uses it updates.

## Example

The brand blue changes. The team updates one token, and the website, iPhone app and Android app all turn the new blue.

## Example code

```css
:root {
  --color-primary: #2563eb;
  --space-2: 8px;
}
.button { background: var(--color-primary); }
```

In CSS a token is often a custom property. Parts use the name, never the raw value.

## Why it matters

One change in one place reaches every product, so the brand never drifts.

## Common mistake

Naming tokens after their value, like blue-500 for a button. Name the job, then the value can change.

## Three principles

- **A name for a value.** Color, size, space.
- **Stored once.** Shared by design and code.
- **Change once.** Updates everywhere.

## Related terms

- [Primitive Token](https://learn.benibix.com/term/design/primitive-token)
- [Semantic Token](https://learn.benibix.com/term/design/semantic-token)
- [Design System](https://learn.benibix.com/term/design/design-system)
- [Theming](https://learn.benibix.com/term/design/theming)
- [Component Token](https://learn.benibix.com/term/design/component-token)
- [Motion Token](https://learn.benibix.com/term/design/motion-token)

![Three columns joined by arrows. A primitive token, blue-600, holds a raw hex value. A semantic token, color-primary, points to blue-600. A component token, button-background, points to color-primary.](https://learn.benibix.com/diagrams/design-token-tiers.svg)

---

Source: https://learn.benibix.com/term/design/design-token
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
