v2.4.2 Fix March 14, 2026

# Figma Variables sync fix

Variable tokens with slash-separated names were stripped on export. Resolved. No action required from users.

Share:
X
LinkedIn

A bug introduced in v2.4.0 caused Figma variable tokens with slash-separated names to be silently dropped during export.

Specifically, tokens like `color/brand/primary` or `spacing/layout/gap-sm` were being interpreted as path separators by our export pipeline, which stripped everything after the first `/`. The resulting spec showed the fallback value rather than the live token reference.

## What was affected

Any variable token whose name contained a `/` character. Slash-separated naming is the default convention recommended in Figma’s Tokens Guide — so this affected the majority of design systems using the standard naming pattern.

## The fix

We now escape `/` in variable names before passing them to the export pipeline. The raw token name is preserved exactly as defined in Figma. No data was lost — the fix requires no action from users. Existing specs that exported with the bug will reflect the corrected values on next sync.

## Inline code example

The old behavior truncated `color/brand/primary` to `color`. The corrected behavior preserves the full token path: `color/brand/primary → #4F46E5`.

Thanks to everyone who reported this via support — the first report came in within four hours of the v2.4.0 release and the fix was prioritized immediately.

← Back to changelog

Free MIT template · Day 29 of 365

You're looking at a demo. Download the built static files or grab the full Astro source to customize.

↓ Download static ↓ Source (Astro) All 365 → Hire me →