Skip to content
BENIBIX Learn

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.

Design📐 Design Standards

Primitive Token

A token for one raw value, like one exact blue. It has no job yet.

A primitive token is a design token that names a raw value, like blue-600 for one exact blue or space-4 for 16 pixels. It says what the value is, not where to use it. Primitives form the full palette of choices. Parts of the interface should not use them directly; they use semantic tokens, which point to primitives.

Example
The palette holds blue-100 to blue-900. None of them say button; they are just the paints.
Why it matters
A fixed set stops a product from piling up dozens of blues. Most of them would look almost the same.
Full entry
Design📐 Design Standards

Semantic Token

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

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.
Why it matters
A new theme or a new brand look is then just a change of pointers. Nothing is rewritten.
Full entry

In one line

Primitive Token
A token for one raw value, like one exact blue. It has no job yet.
Semantic Token
A token named for its job, like color-danger. It points to a raw value.