---
date: 2026-03-14
version: "v2.4.2"
title: "Figma Variables sync fix"
tags: ["Fix"]
summary: "Variable tokens with slash-separated names were stripped on export. Resolved. No action required from users."
draft: false
---

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](https://help.figma.com/hc/en-us/articles/15339657135383) — 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.
