---
title: "How to Set Up Design Tokens in Figma (2026)"
description: "A step-by-step 2026 guide to setting up design tokens in Figma — primitives, semantic tokens, modes for light/dark, and syncing to code as JSON or CSS"
url: https://www.shaheermalik.com/blog/how-to-set-up-design-tokens-in-figma
language: en
format: agent view of this page (the same content as the page, as plain text)
updated: 2026-11-16
---

[← All posts](https://www.shaheermalik.com/blog)

[Product Design](https://www.shaheermalik.com/blog/category/product-design)

# How to Set Up Design Tokens in Figma (2026 Guide)

A practical, step-by-step guide to setting up design tokens in Figma variables in 2026 — from primitive colours to semantic tokens, light/dark modes, and syncing to code as JSON or CSS custom properties.

Image: Shaheer Malik

Shaheer Malik

Framer Designer & Developer

July 4, 2026 6 min read

Quick answer

Set up design tokens in Figma in three layers: primitives holding raw values like blue-500, semantic tokens that reference them by role such as color-action, and modes for theme switching. Components should only ever bind to semantic tokens, so a theme change never requires touching a component.

**To set up design tokens in Figma, use Figma Variables: define primitive values (raw colours, a spacing scale, type sizes), then layer semantic tokens on top that reference them, add modes for themes like light and dark, and sync the whole set to code as JSON or CSS custom properties.** That two-tier structure is what lets you change a value once and update it everywhere.

## What design tokens are (in one line)

Design tokens are named variables that store your core design decisions — colours, spacing, type, radii — so they live in one place instead of being hardcoded across hundreds of components. For the short definition, see the [design tokens glossary entry](https://www.shaheermalik.com/glossary/design-tokens).

## Step 1 — Define primitives

Create raw, context-free values first: a full colour ramp (e.g. blue-50 to blue-900), a spacing scale (4, 8, 16, 24, 32), type sizes, and radii. These are the palette — they describe _what a value is_, not where it's used.

## Step 2 — Add semantic tokens

Layer meaning on top by creating tokens that reference the primitives: `color-primary → blue-600`, `color-surface → grey-50`, `space-card-padding → 16`. Now components use the semantic token, so re-theming or re-mapping a value happens in one place.

## Step 3 — Use modes for themes

Figma Variables support modes — set up a Light and Dark mode on your semantic collection, mapping each semantic token to the right primitive per mode. A component bound to `color-surface` then adapts automatically when you switch modes.

## Step 4 — Bind tokens to components

Apply the semantic tokens to your components' fills, spacing and text styles. From here, updating the token updates every instance — no manual sweep across screens.

## Step 5 — Sync to code

Export the variables to a shared format — JSON or CSS custom properties — so engineering consumes the exact same tokens. Both design tools and code reading one source is the standard approach, and it's what closes the gap between design and production.

## Where tokens fit in the bigger picture

Tokens are Phase 2 of building a real system. To see how they connect to component architecture, documentation and governance, read the full guide to [scalable design systems for digital products](https://www.shaheermalik.com/blog/scalable-design-systems-for-digital-products).

FAQ

## Frequently asked questions

01 What's the difference between primitive and semantic tokens?

Primitives are raw values (blue-600, 16px); semantic tokens give them meaning (color-primary, space-card-padding) by referencing primitives. Components use semantic tokens so changes propagate from one place.

02 Can Figma variables sync to code?

Yes — you export them as JSON or CSS custom properties so engineering consumes the same tokens, keeping design and code in lockstep.

03 Do I need a plugin for design tokens in Figma?

Figma's native Variables cover most needs; plugins help with advanced export pipelines and formats, but you can start with variables alone.

04 What are design tokens?

Named values for design decisions — colour, spacing, type, radius — stored once and referenced everywhere. Changing the token changes every place it is used, which is what makes a system maintainable.

05 How do you handle light and dark themes with Figma variables?

Use modes. Keep one set of semantic tokens and give each mode its own values, so switching the mode re-themes the design without duplicating components or styles.

[Design Tokens](https://www.shaheermalik.com/blog/tag/design-tokens) [Design Systems](https://www.shaheermalik.com/blog/tag/design-systems) [Product Design](https://www.shaheermalik.com/blog/tag/product-design)

Share: [X / Twitter](https://twitter.com/intent/tweet?url=https%3A%2F%2Fwww.shaheermalik.com%2Fblog%2Fhow-to-set-up-design-tokens-in-figma&text=How%20to%20Set%20Up%20Design%20Tokens%20in%20Figma%20%282026%20Guide%29) [LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fwww.shaheermalik.com%2Fblog%2Fhow-to-set-up-design-tokens-in-figma)

Want it done for you? I offer [product design](https://www.shaheermalik.com/services/product-design) on a fixed price, from $700\. [See pricing](https://www.shaheermalik.com/pricing).

On this page

- [What design tokens are (in one line)](#what-design-tokens-are-in-one-line)
- [Step 1 — Define primitives](#step-1-define-primitives)
- [Step 2 — Add semantic tokens](#step-2-add-semantic-tokens)
- [Step 3 — Use modes for themes](#step-3-use-modes-for-themes)
- [Step 4 — Bind tokens to components](#step-4-bind-tokens-to-components)
- [Step 5 — Sync to code](#step-5-sync-to-code)
- [Where tokens fit in the bigger picture](#where-tokens-fit-in-the-bigger-picture)

Keep reading

[ Product Design Shaheer Malik Design Systems AI Agents Can Build With (2026 Guide) The five layers that let Claude Code, Cursor and Codex build on your design system instead of guessing: tokens, components, rules, the Figma MCP server and a registry. October 29, 2026 8 min read](https://www.shaheermalik.com/blog/design-systems-ai-agents)

[ Product Design Shaheer Malik Why Your App Doesn't Match the Figma File: Fixing the Design Handoff Where the gap between Figma and the shipped app comes from, what design tokens fix and what they don't, and what a complete handoff includes. October 8, 2026 6 min read](https://www.shaheermalik.com/blog/app-doesnt-match-figma-design-handoff)

[Product Design Designing a Calm Health App: The Cafeity Case Study How I designed Cafeity to be calm: trends instead of verdicts, labelled estimates, an AI that never computes a number, a one-page Visit Summary, and what I cut along the way. October 2, 2026 9 min read](https://www.shaheermalik.com/blog/designing-cafeity-calm-health-app-case-study)

## What you can do here
- Get a fixed-price proposal: https://www.shaheermalik.com/proposal/chat (describe the project in a sentence or two)
- Free website audit: https://www.shaheermalik.com/audit?site=example.com (replace example.com with the site; the score needs no email)
- Book a free scope call: https://www.shaheermalik.com/fixed-price-website#book
- Contact: https://www.shaheermalik.com/contact
- Prices and facts for the whole site: https://www.shaheermalik.com/llms.txt

## Structured data

```json
{
 "@context": "https://schema.org",
 "@type": "BlogPosting",
 "headline": "How to Set Up Design Tokens in Figma (2026 Guide)",
 "description": "A step-by-step 2026 guide to setting up design tokens in Figma — primitives, semantic tokens, modes for light/dark, and syncing to code as JSON or CSS",
 "abstract": "Set up design tokens in Figma in three layers: primitives holding raw values like blue-500, semantic tokens that reference them by role such as color-action, and modes for theme switching. Components should only ever bind to semantic tokens, so a theme change never requires touching a component.",
 "datePublished": "2026-07-04T13:00:00.00+00:00",
 "dateModified": "2026-08-12T00:00:00.00+00:00",
 "author": {
  "@type": "Person",
  "name": "Shaheer Malik",
  "url": "https://www.shaheermalik.com"
 },
 "publisher": {
  "@type": "Person",
  "name": "Shaheer Malik",
  "url": "https://www.shaheermalik.com"
 },
 "mainEntityOfPage": "https://www.shaheermalik.com/blog/how-to-set-up-design-tokens-in-figma"
}
```
