Start a design system from a Figma file
Send a Figma file's variables, styles, logos and icons to Design System Studio, then review them in the portal.
The design language's Figma plugin can send a file's colour variables, text styles, shadows and the layers you mark to the portal, where they wait for you to review them as a new design system. Use it when your brand already lives in Figma.
Before you start
- Install the Figma plugin from the portal's Connect page.
- Create an access token with the designer role or above under Access tokens (/admin?tab=tokens). See Access tokens. Only a token can send; a signed-in browser can't.
Send from Figma
- Open your file in the Figma desktop app and run the plugin.
- Open the Design System Studio tab. It lists the variables, modes, text styles and effect styles it found.
- Under Light mode and Dark mode, check which mode is which. The plugin guesses by name when it can.
- Select the layers to include (frames, components, vectors or groups). In the Selected layers table, choose what each is used as: a logo (full, full on dark, mark, mark on dark, favicon), an Icon or a Wordmark.
- Enter the Portal address and Access token, then choose Send.
To keep the bundle as a file instead, choose Download file. It is the same zip, up to 10 MB.
Review it in the portal
- Open Manage design systems (/brands), choose New design system, then From Figma.
- Find your file in the list and choose Review. The review screen opens, as it does for imported files.
- Check what matched, place anything that didn't, and choose Create design system.
A downloaded zip goes through Import files on the same page instead.
What Figma sent waits for 7 days, then is deleted. It is also removed once you create its design system, or when you choose Remove. Your organisation can hold 20 at a time. Only designers and above see the list.
Fonts
Figma doesn't let plugins export font files. The plugin lists the families the file uses; upload their files on the studio's Type tab after the draft is created.
If something goes wrong
| What you see in the plugin | What to do |
|---|---|
| "This token can't send; it needs the designer role or above." | Create a token with the designer role or above. |
| "Too many bundles are already waiting in this organisation." | In the portal, open From Figma and remove one you no longer need. |
| "The bundle is too large for the portal (10 MB at most)." | Select fewer layers and send again. |
| "Couldn't reach …" | Check the portal address starts with https:// and that the plugin may reach it. |
| "The portal is limiting requests." | Wait a minute and try again. |