All Collections
Collect design data from Sources
How to Collect Figma Variables from Figma to Specify?
How to Collect Figma Variables from Figma to Specify?
Maud Miguet avatar
Written by Maud Miguet
Updated over a week ago

Table of content

Before getting started

To get the most out of this guide, you will need:

1. Sync your Figma variables with a Specify repository

  • Access your Figma file which includes the variables you would like to sync to Specify

  • Download ↗ the Specify Widget in the Figma file which includes your Variables. Or update the widget if you already have it. To update the Specify Widget you have to disconnect it, remove the entire frame in all of your Figma files, and reopen the latest version of the Widget.

2. Connect your Specify account

  1. Follow the steps in the widget to connect your account. You will need to create a personal access token and you will need to add the link to the Figma file to which the widget is added. Watch tutorial ↗

  2. Click "Connect"

  3. Choose Local variables

Note: the widget can be used for syncing Figma Local Styles as well, you are able to switch between the two by clicking "Switch to".

3. Create a repository in Specify

  1. Go to your Specify workspace

  2. Click on "Create repository"

  3. Choose a name

  4. Select "Sync from Figma Variables" (Learn more ↗︎)

  5. Click "Create repository"

Create a repository in Specify

4. Connect the Specify repository in your Widget

  1. Go back to your Figma file that includes the Variables

  2. Click on "Create Source" in the Specify Widget

  3. It will show you the collections that are detected

  4. Select the Specify repository you want to sync with. You should be able to see the Repository you have just created in Specify (if not, reload the list).

  5. Click "Save to Specify"

  6. You will immediately see the repository listed with the latest syncing time

Make sure to understand that only repositories that can sync Figma variables are listed here.

Create a source in your Specify Widget in your Figma file

5. Sync updated variables on the fly

Use the Sync button to update your variables with Specify. Now you are ready to export your design tokens! 🎉

Use the sync button to update new variables

6. Check your source inside the Specify interface

  • You will see the category of design tokens that are synced on the left-hand side

  • In the Sources section (left-hand menu), you will see your connection(s) and when the last sync between your Figma file and Specify repository has occurred.

Did this answer your question?