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.
Questions & answers
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
- Atlassian’s llms-tokens.txt (opens in a new tab)
Semantic tokens named by purpose, each with a light value, a dark value and a line on its use.
- Design Tokens Format Module 2025.10 (opens in a new tab)
Aliases, where one design token’s value is a reference to another.
- Material Web, theming (opens in a new tab)
System tokens that hold a design system’s decisions and roles, above reference tokens with concrete values.
Continue this reading path
Tokens and data
Tokens and data
Agent access and docs
Selection and fit
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 (opens in a new tab)The flagship: 12 public design systems compared, each rating linked to its proof
- Best AI Design System (opens in a new tab)A buyer’s guide to picking the one design system your agents follow
- Simbolik (opens in a new tab)Simon Martin’s studio: the AI Systems service, design and brand systems, advisory
- Simbolik Design System (opens in a new tab)The free design system Simbolik builds on, with its rules for agents
Cite this entry
Best AI-Ready Design Systems. “Semantic token.” Reviewed . https://bestaireadydesignsystems.com/glossary/semantic-token/