Token blocks

Display design tokens in your documentation.

If you are using themes in your design system, you can apply them to your tokens and choose between layout options to display 1 or 2 swatches in the token preview.

Apply a theme to tokens

Theme token - Swatches

Applying themes to a swatch overrides the base values of the tokens with theme values in your published documentation. Any base tokens without a theme value will continue displaying their base values.

Apply multiple themes to tokens

Applied modes in Figma and themes in Supernova.

Applied modes in Figma and themes in Supernova.

Applying multiple themes in Supernova works the same way as modes in Figma — when you apply multiple themes to a swatch, they will be applied recursively.

An example of how themes are resolved when multiple are applied.

An example of how themes are resolved when multiple are applied.


Reorder themes

You can drag and drop to reorder themes in swatches.

The order of applying themes is important because it ensures that the base theme (like brand) is set first, while more specific themes (like dark mode or contrast enhancements) can override relevant properties without breaking references.


Remove a theme

To remove theme from swatch, hover over the row and click on the Remove theme button on the far right.


Examples

Semantic / Warning
#fbeed1
warning.color
#fad961
warning.icon
#ba7506
warning.border
#8b4f1f
warning.background
Semantic / Warning
#fbeed1
warning.color
#fad961
warning.icon
#ba7506
warning.border
#8b4f1f
warning.background
Semantic / Warning
#8b4f1f
#fbeed1
warning.color
#ba7506
#fad961
warning.icon
#fad961
#ba7506
warning.border
#fbeed1
#8b4f1f
warning.background
Semantic / Warning
#8b4f1f
#fbeed1
warning.color
#ba7506
#fad961
warning.icon
#fad961
#ba7506
warning.border
#fbeed1
#8b4f1f
warning.background