# Component Token

> A token for one part, like button-background. It lets you change that part alone.

**Field:** Design  
**Category:** Design Standards  
**Also known as:** Component-Specific Token, Component-Level Token

## Think of it like

It is like a sticker on one toy box that says its color. Change that sticker, and only that box changes.

## Definition

A component token is a design token that belongs to one part, such as the background of a button. It is the third tier of tokens. It points to a semantic token, and that one points to a raw value. So a team can change one part and leave alone every other part that shares its color. Many teams leave this tier out until a part needs a setting of its own.

## Example

The team wants buttons a bit darker than links. They point button-background at a new value, and the links stay the same.

## Example code

```css
:root {
  --color-primary: var(--blue-600);
  --button-background: var(--color-primary);
}
.button { background: var(--button-background); }
```

The button reads its own token, and that token points to the shared one.

## Why it matters

It gives each part a safe handle. A change to one part cannot spill into the others by accident.

## Common mistake

Making one of these tokens for every value on day one. Hundreds of tokens that no one uses are hard to keep tidy.

## Three principles

- **Belongs to one part.** The name says which.
- **Points to a semantic token.** Not to a raw value.
- **Add it when needed.** Not for every value.

## Related terms

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

![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/component-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.
