Figma Data Limits

You may have noticed the size of your Token project is showing in the footer of the plugin.

This can happen when you:

  • Import a large volume of Styles or Variables from Figma.

  • Upload a Token project into Tokens Studio from a JSON file or folder.

  • Expand an existing Token project to have more Token Sets or Themes.

As soon as the Plugin detects the project size is at 100kb and set to Local Document storage:

  • The footer of the Plugin will display your current file size.

  • You can select the file size to open a modal with easy access to more information.

    • Selecting the View Storage Settings actions brings you to the settings page where you can add a new sync provider.

Having a Token project that is over 100kb isn't a problem, it means you are doing great work! However, Figma's efforts to tackle their performance issues means Plugins like Tokens Studio are being limited by Figma.

The user flow for Token projects that exceed Figma's 100kb file size limit is pictured. On the right, the Tokens Page of the plugin has the file size highlighted in the bottom left. Selecting the file size opens the informational picture in the middle. The far right image shows the Settings page of the plugin currently set to store the Token data as Local Document, with the Add new sync provider action highlighted.

Why is this happening?

The Tokens Studio Plugin uses Figma's plugin API to to interact with your design elements, styles and variables.

As of May 2025, Figma is enforcing a limit on how much data a plugin can store in a Figma file via its setSharedPluginData API call.

The total size of your entry (namespace, key, value) cannot exceed 100 kB. - Figma Developer, Plugin API

This means, if you are using Local Document storage for your larger projects (small component libraries, lots of variables etc), you are likely to hit the 100kb data limit.

The data limit does not apply if you are syncing your Tokens to a remote storage provider as the Token project data is being stored outside of the Figma file.

How it works

There is no action required by you! The plugin will work some magic under the hood to keep file sizes as small as possible.

Whats happening under the hood?

When the Plugin detects the project size is at 100kb and set to Local Document storage, it will:

  • Compress the data and break it into chunks smaller than 95kb when writing to Figma

  • Combine the chunks and decompress when reading from Figma.

When the Plugin is storing Token data remotely and you close the Plugin before you have pushed changes to your sync provider, the Plugin will:

  • Store the changes you haven't pushed using a different API figma.clientStorage which stores it locally to your machine.

  • Client storage still has a data limit, but it is much larger (5mb).

However, this process takes time! You will notice the Plugin starts to perform tasks slower as your file size increases.

The best way to avoid slowdowns in your workflow is to store your Tokens remotely using one of our integrated sync providers.

Sync Tokens to remote storage to avoid issues

Figma's 100kb data limit only applies when a plugin has to store (or save) information locally to the Figma File.

This means, if you switch to a remote storage provider, the data limit does not apply and the plugin does not perform the extra steps listed above, giving you optimal performance in your Figma file.

Remote storage guides

If you haven't set up a remote sync provider yet, don't worry! These guides will walk you through it.

If you don't know which sync provider to use, try Github as a free option.


Resources

Figma API Documentation Mentioned:

Known issues and bugs

Tokens Studio Plugin GitHub - Open issues for Sync Local Storage

🐞 If you are experiencing an issue not listed here, please reach out to us on the Troubleshooting channel of our community Slack, submit it on our feedback tool, or send us an email [email protected]

Requests, roadmap and changelog

  • None yet

💌 Visit https://feedback.tokens.studio/ to contribute or subscribe to updates.

Last updated

Was this helpful?