Changelog

Follow new updates and improvements to Tokens Studio.

February 4th, 2026

πŸš€ New Features

Variable Scoping & Code Syntax - We’ve added a powerful new way to manage your design system data

  • Scope Variables: Precisely define where variables are applied in Figma (e.g., strokes, fills, text).

  • Add Code Syntax: Include custom syntax (like CSS variables) directly in your tokens for smoother developer handoff.

  • Automatic Sync: Scoping and syntax settings automatically sync to Figma variables and back to Tokens Studio, ensuring consistency across all modes (as seen in the recording below)

Quick Provider Selection - You can now switch sync providers directly from the Start Screen via a new dropdown.

  • Faster Access: Select providers without navigating to Settings.

  • Auto-Sync: Tokens are pulled automatically upon selection (no confirmation dialog needed).

  • Smart Defaults: The plugin now auto-selects the first theme from each group for a quicker setup.

✨ Improvements

  • Export Gradients as Styles: users can now export color tokens with linear-gradient values as Figma styles by enabling the "Gradients" checkbox in the Styles section of the export options.

  • More Bitbucket Branches: We increased the API request limit to 100, so you will now see a much comprehensive list of your branches.

  • DTCG by Default: The default format for the plugin is now set to DTCG standard.

πŸ› Bug Fixes

  • Fixed Token Bleeding: Solved an issue where token changes would accidentally "bleed" or carry over between branches when switching or creating a new branch.

  • Gradient Export Fix: Gradient tokens with trailing spaces now export correctly as styles without error.

December 11th, 2025

Fixes 🐞

  • Fix Bitbucket alphabetical reordering of token sets on sync, makes branch selection dropdown scrollable and searchable for all remote branches - as seen in the recording below

    • A big thanks to Memo LΓ³pez for their contribution!

  • Adjusted generic versioned storage to store additional headers in clientStorage instead of sharedPluginData.

December 4th, 2025

✨ Improvements

  • Add search functionality to the Export to Figma dialog for filtering Themes and Sets - as seen in the recording below

  • Add error handling for failure when writing to clientStorage property in Figma

🐞 Fixes

  • Fix trigger document update when importing variables to ensure they persist in local themes and sets

  • Fix switch to first imported token set when current set is not in imported sets after variable import

December 1st, 2025

🐞 Fixes:

  • Fix the variable export regression for external library variables introduced in v2.10.6

    • Removed overly strict validation that was filtering out remote/library variable references. Added fallback mechanism in updateVariablesToReference to find variables by name when import by key fails. This restores the ability to properly attach variable references from published libraries in non-local setups - As seen in the recording below

  • Fix the bug where tokens were incorrectly resolved during export when expand options are enabled. When using "Export to JSON" with options like "Expand Typography" enabled, alias tokens (references like {typography.heading.h1}) will now keep their references instead of being resolved to actual values. This preserves the token relationships needed for downstream processing pipelines.

  • Fix the issue with spacing tokens that are set to AUTO and switch back to a number/dimension value, which caused other token changes to be ignored - Contributed by lethxrgy1

  • Remove Storyblok integration and changelog dialog feature. The changelog dialog functionality has been removed and can be brought back with a different system in the future.

  • Add support for vertical trim (cap to baseline) on boolean tokens. Boolean tokens can now be applied to text nodes to enable or disable leadingTrim (vertical trim) feature in Figma.

November 20th, 2025

✨ Improvements:

  • Improve variable creation performance with batching, and tighten progress tracking; fixes theme token-source handling.

  • Added batching for variable creation to avoid memory-related issues.

  • Faster alias linking and caching for imports.

  • Clear progress phases and accurate counts.

November 18th, 2025

Fixed an issue where letterSpacing values of 0 were being treated as empty and omitted from exported tokens.

November 7th, 2025

🐞 Fixes:

  • Fixed an issue that caused the plugin to stay in read-only mode

November 5th, 2025

✨ Improvements

Accurate Base fontSize per Theme:

  • Fixed an issue where multi-theme exports always used the active theme’s base font size for rem conversion. Each theme now correctly applies its own baseline.

Enhanced rem Display Across UI:

  • Rem values now automatically show their pixel equivalents (e.g., 1rem (16px)) based on each theme’s baseline font size. This makes token inspection and comparisons clearer and more intuitive.

Improved Typography Token Export:

  • Exporting typography tokens now uses resolved values per theme, ensuring font sizes and related properties reflect the correct baseline across themes.

🐞 Fixes

  • Incorrect base URL for GitHub Enterprise API calls causing some sync failures.

October 15th, 2025

✨ New Features

πŸ” Figma Variable Mode Sync
The plugin now automatically switches Figma variable modes when you change themes.
What’s new:

  • Automatically updates Figma’s variable modes to match your selected theme

  • Configurable toggle: Settings β†’ Swap Figma variable modes (enabled by default)

  • Validates collections and modes before switching, with clear error messages if something’s missing

  • Works across Selection, Page, and Document update modes

πŸ“‚ β€œLoad from Preset” as a Separate Action
We’ve split β€œLoad from file or preset” into two focused actions:

  • Load from file/folder and Load from preset - Each now opens a dedicated dialog for smoother workflows.

πŸ”„ Instant Feedback When Switching Git Branches

  • Added an immediate loading indicator when switching Git branches to provide instant user feedback.

βž• New Token Sets Enabled by Default

  • Newly created token sets now start enabledβ€”no more manual toggling after creation.

πŸ› οΈ Fixes & Improvements

  • Theme Modal Behavior: Pressing ESC in the Manage Themes modal now only closes the theme editor, not the entire modal.

  • Typography & Variable Import:

    • Fixed {undefined} values appearing in text style imports using Figma variables.

    • Font sizes, line heights, and spacing values now import as proper numbers.

    • Typography tokens now gracefully fall back to raw values if references are missing.

  • Variable Reference Consistency: Fixed inconsistent variable reference behavior when not using theme groups β€” variable references now correctly prioritize variables from the same collection.

  • GitLab Sync: Fixed an issue where a non-existent file wasn’t created when setting up a new sync.

  • Bitbucket Branch Names: Fixed branch names containing slashes not being processed correctly.

↔️ 100% Tokens Apply as β€œFill Container”
Tokens with a value of 100% now behave more intuitively:

  • Auto layout frames: fill the container

  • Regular frames: stretch to match the parent’s width

β˜‘οΈ Clearer Delete Confirmation Dialog

  • The delete token dialog now shows the specific token name instead of the generic β€œthis token”.

September 22nd, 2025

✨ New Features

🌈 Expanded Gradient Support

The plugin now supports radial and conic gradients in addition to linear gradients:

  • radial-gradient() β†’ mapped to Figma’s GRADIENT_RADIAL

  • conic-gradient() β†’ mapped to Figma’s GRADIENT_ANGULAR

  • Backward compatibility with existing linear gradients

  • Updated reference token extraction for all gradient types`

🎯 Auto-Apply Theme on Component Drop

You can now automatically apply the active theme when inserting component instances into your Figma designs. No more manually applying tokensβ€”new components instantly inherit your theme styling.

  • Smart theme application: Active theme tokens are applied to newly inserted components.

  • Configurable: Toggle Auto-apply theme on drop in plugin settings (bottom right).

πŸ“– Regex Support in Living Documentation

When generating documentation, you can now choose between:

  • Simple "starts with" matching (default)

  • Regex pattern matching for more advanced filtering

πŸ› οΈ Improvements & Fixes

  • Bulk Remap

    • Added toggle to enable/disable regex matching (default: literal string matching).

    • Fixed broken token connections when using special regex characters (e.g. ..).

  • Variables

    • Prevented unnecessary variable alias recreation (no more false "changed" states in Figma).

    • Improved color/number variable precision: switched from rounding to clipping, normalised to 6 decimals.

  • Sync Providers

    • Fixed issue where users couldn’t create empty files, folders, or branches during sync setup.

    • Fixed Bitbucket sync issue affecting users with new API tokens.

  • Tokens & Sets

    • Fixed duplication bug: tokens are now only duplicated to explicitly selected sets (source set excluded if deselected).

    • Fixed persistent blue dot when renaming a token set.

  • UI & Usability

    • Enter key now submits rename forms correctly.

    • Typography preview updated from "aA" to "Aa" in docs and inspector.