Skip to content
Agentic Experience Design Language Help Go to the portal

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.

For designers, publishers and admins2 min read

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

  1. Open your file in the Figma desktop app and run the plugin.
  2. Open the Design System Studio tab. It lists the variables, modes, text styles and effect styles it found.
  3. Under Light mode and Dark mode, check which mode is which. The plugin guesses by name when it can.
  4. 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.
  5. 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

  1. Open Manage design systems (/brands), choose New design system, then From Figma.
  2. Find your file in the list and choose Review. The review screen opens, as it does for imported files.
  3. 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

If something goes wrong
What you see in the pluginWhat 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.