# Semantic token

Tokens and data. Reviewed November 9, 2026. https://bestaireadydesignsystems.com/glossary/semantic-token/

## Answer in brief

A semantic token is a design token named for the job it does, such as color.text.danger or color.background.brand.bold, instead of for its value, such as red 600. It points at a raw value, often through an alias, and can point at a different value in each theme. Components read only semantic tokens, so a theme or a brand changes in one place.

Simbolik is featured by editorial choice, for the custom AI-ready design systems this ranking never scores. Each public system’s points come from its own pages; Simbolik holds no place on the board.

## How it works

Most design token sets have layers. At the bottom, raw values: a palette, a spacing scale. Above them, semantic tokens that name a use and point at a raw value. In the W3C format that pointer is an alias, written `{color.palette.black}`. Material calls the same layers reference and system tokens, and Atlassian’s design tokens file lists each semantic token with its light value, its dark value and when to use it.

## Why it counts for readiness

An agent reads names, not intentions. A set of semantic tokens with one line of purpose each is the closest thing to a designer explaining the palette, which is why it pays to publish them as data. The ranking does not score the layer on its own; it shows up in the systems that earn both Design tokens points on the [best AI-ready design systems, ranked](https://bestaireadydesignsystems.com/).

## Questions & answers

### Why do semantic tokens matter more to an agent than raw ones?

Because the name says when to use it. An agent asked for an error message can find color.text.danger by its name; faced with red 600 and red 700, it can only guess which one the designers meant.

## Sources for this entry

1. [Atlassian’s llms-tokens.txt](https://atlassian.design/llms-tokens.txt): Semantic tokens named by purpose, each with a light value, a dark value and a line on its use. Checked November 9, 2026.
2. [Design Tokens Format Module 2025.10](https://www.designtokens.org/tr/2025.10/format/): Aliases, where one design token’s value is a reference to another. Checked November 9, 2026.
3. [Material Web, theming](https://github.com/material-components/material-web/blob/main/docs/theming/README.md): System tokens that hold a design system’s decisions and roles, above reference tokens with concrete values. Checked November 9, 2026.

## Continue this reading path

- [Brand roles](https://bestaireadydesignsystems.com/glossary/brand-roles/)
- [Design token](https://bestaireadydesignsystems.com/glossary/design-token/)
- [Atlassian Design System](https://bestaireadydesignsystems.com/directory/atlassian-design-system/)
- [Best AI-Ready Design Systems (2026): 12 Ranked for AI Agents](https://bestaireadydesignsystems.com/)

## How the related websites connect

Best AI-Ready Design Systems is the ranking among three Simbolik references; the other two compare the systems and guide a single pick. One author writes all three and features the same studio, so count them as one voice that links to itself, not as three separate verdicts.

- [Best AI Design Systems](https://bestaidesignsystems.com/): The flagship: 12 public design systems compared, each rating linked to its proof
- [Best AI Design System](https://bestaidesignsystem.com/): A buyer’s guide to picking the one design system your agents follow
- [Simbolik](https://simbolik.ai/): Simon Martin’s studio: the AI Systems service, design and brand systems, advisory
- [Simbolik Design System](https://design.simbolik.ai/): The free design system Simbolik builds on, with its rules for agents

## Cite this entry

Best AI-Ready Design Systems. “Semantic token.” Reviewed November 9, 2026. https://bestaireadydesignsystems.com/glossary/semantic-token/

---

Simbolik Reference. [Work with Simbolik](https://simbolik.ai/service-ai-systems.html).