# Semantic Token

> A token named for its job, like color-danger. It points to a raw value.

**Field:** Design  
**Category:** Design Standards  
**Also known as:** Alias Token, Purpose Token, Decision Token

## Think of it like

It is like a job title. The title says teacher, and the person filling it can change.

## Definition

A semantic token is a design token named for its job. One might be the color for text, or the color for danger. It points to a primitive token rather than holding a raw value. Parts on the screen use these tokens. For a dark theme, the team points the same tokens at other raw values. Nothing else has to change.

## Example

color-background points to white in the light theme and to near-black in the dark one. No component changes.

## Example code

```css
:root { --color-background: var(--white); }
[data-theme="dark"] { --color-background: var(--grey-900); }
```

The same job name points to a different raw value in each theme.

## Why it matters

A new theme or a new brand look is then just a change of pointers. Nothing is rewritten.

## Common mistake

Making one for each single use. Keep the list short, so people can remember it.

## Three principles

- **Named for the job.** Text, danger, surface.
- **Points to a primitive.** Holds no raw value.
- **Makes themes easy.** Swap the pointers.

## Related terms

- [Design Token](https://learn.benibix.com/term/design/design-token)
- [Primitive Token](https://learn.benibix.com/term/design/primitive-token)
- [Theming](https://learn.benibix.com/term/design/theming)
- [Dark Mode](https://learn.benibix.com/term/design/dark-mode)
- [Component Token](https://learn.benibix.com/term/design/component-token)

## Told apart from

- [Primitive Token vs Semantic Token](https://learn.benibix.com/compare/primitive-token-vs-semantic-token): A primitive token names a raw value, like one exact blue. A semantic token names a job, like the main brand color, and points to a primitive. Parts should use the semantic one.

---

Source: https://learn.benibix.com/term/design/semantic-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.
