Number tokens
Store reusable numeric values — spacing, radius, sizing — as design tokens.
What number tokens are used for
Number tokens store any numeric value that you want to reuse consistently across a design:
- Spacing — gaps between elements, padding inside components (e.g.,
4,8,16,32) - Corner radius — rounded corners on buttons, cards, inputs
- Sizing — icon sizes, border widths, fixed dimensions
- Other — any numeric property that should stay consistent
Creating a number token
- Open the Tokens tool from the editor toolbar.
- Click Add token and select Number as the type.
- Name the token descriptively — use a semantic role rather than the literal value:
spacing/sm,spacing/md,spacing/lgradius/base,radius/pillborder/thin
- Enter the numeric value (in pixels, or as a unitless number — check how your token set expects values).
- Save the token.
Using a number token value
After creating number tokens, copy the reusable numeric value into inspector fields such as corner radius, gap, padding, width, or height. See Apply tokens in design for the current workflow.
Building a spacing scale
A well-organized spacing token set uses a consistent multiplier:
| Token name | Value |
|---|---|
spacing/1 | 4 |
spacing/2 | 8 |
spacing/3 | 12 |
spacing/4 | 16 |
spacing/6 | 24 |
spacing/8 | 32 |
Spacing scales like this make layouts predictable and reduce arbitrary pixel values in the design.
Tips
- Name tokens by role, not value —
spacing/smis more maintainable thanspacing/8pxbecause the name stays accurate if the value changes. - Build your spacing and radius scales before designing components so you can reuse consistent values from the start.