Naming design tokens

How to effectively name your design tokens in a systematic and future-proof way.

Design tokens are the single source of truth for design primitives like colors or tokens. If you are new to the topic, you may want to learn the basics of design tokens first.

Note: This article aims to be an exhaustive reference for naming design tokens. If you find some information is missing, please do let me know via a comment or email so I can add it.

Naming token levels

Tokens are commonly split into different levels, each level has a specific use case, which I will explain later.

There are a few common names for this level concept:

• token levels
• token types
• token tiers
• token layers
• token groups

It does not really matter which one you use. However, you should make sure that you choose one that is widely understood within your organisation.

It’s best to choose one name e.g. token tiers and use it consistently. You should also explain it in the beginning of any documentation. Design tokens are complicated enough for people new to the topic, we don't want to make it harder.