Design Tokens are defined by our Designers, with the source of truth located in Figma. This guide serves as a bridge between Figma and Components, transforming Figma variables into meaningful outputs.
Shift+D (Mac) or clicking the Dev Mode toggle button in the UI. If you have trouble entering Dev Mode, refer to this guide.Plugins tab.After completing these steps, you will have a JSON file with all the WDS tokens in the Token Lab format. This file is divided by token levels (Foundation, Semantic, and Component) and themes (wds, studio, and wixel).
Tokens are stored in the src/tokens directory, organized similarly to Token Lab tokens by theme (default (wds), studio, odeditor, odeditor-dark, and studio2-light) and by level (foundation, semantic, and component). Note that the Token Lab output isn't compatible with the Style Dictionary format, so you can't use it directly as a source for Style Dictionary.
Since Token Lab output isn't directly compatible with the format that Style Dictionary uses, you need to either:
For small updates, it's usually quicker to do this manually. Create new entries in the appropriate .json files for the relevant level and theme based on the Token Lab output.
Here's how to do this:
color.text.primary.foundation token. You can determine this from Figma, as every variable belongs to one of these categories: foundation, semantic, or component.packages/wix-design-system-tokens/src/tokens/INSERT_THEME_NAME/foundation.json.color object and check for a nested object called text. If it doesn't exist, create it along with another nested object for the primary key. So it will result in color.text.primary objects sequence.For larger numbers of tokens, adding them manually can be tedious. Our figma-to-dictionary script can help by sanitizing and transforming Token Lab output to match the format used by Style Dictionary. Here's how to use figma-to-dictionary:
figma-to-dictionary/input.json file.input.json.This creates a figma-to-dictionary/output.json file with processed tokens.
figma-to-dictionary/output.json and insert them into the respective .json file in the src/tokens directory.
Once the .json files are updated, you can generate the new Style Dictionary output. To do this, first navigate to packages/wix-design-system-tokens and run:
Then, navigate back to the main entry of monorepo folder and run:
This script creates all the output files like .css and .st.css, which are later used in components.
Last updated: 26 October 2026