three-tier token hierarchy
Organising design tokens into three levels, global, semantic and component, where each level refers to the one below.
In more detail
Global tokens hold raw values, semantic tokens name purposes, and component tokens bind those purposes to specific components. A change at the bottom flows upward automatically. Dark mode, for example, only rebinds semantic tokens and leaves components untouched.
Related terms
- global token — A token that holds a literal value from the full palette, such as blue.500 = #3b82f6, with no meaning attached.
- semantic token — A token named for its purpose, such as color.action.bg or color.surface, that points at a global token.
- component token — A token scoped to one component, such as button.primary.bg, that usually points at a semantic token.
- token alias — A token whose value is a reference to another token, written in curly braces such as {semantic.action.bg}.
Taught in
- Design Tokens: W3C Specs, Global, Semantic & Component Tokens — Design Systems & Component Engineering