Font family

A font name, or a list of names in order of preference.

Partial: a list of two or more names cannot be mapped to a Figma variable. Applying a list to layers works.

Value format

{ "$type": "fontFamily", "$value": "Inter" }

{ "$type": "fontFamily", "$value": ["Inter", "Helvetica", "sans-serif"] }

A list needs at least one name. In a file, write a list as an array: a comma inside one string is not read as a list, and such a value cannot be applied.

In Syntope Tokens

You type	Stored as
Inter	"Inter"
Inter, Helvetica, sans-serif	["Inter", "Helvetica", "sans-serif"]
"Foo, Inc"	["Foo, Inc"]
{font.body}	A reference

Quotes follow CSS rules. Use them around a name that contains a comma.

Applying to layers

Apply token works on text layers. For each styled range, the plugin keeps the current face name, such as Medium, and changes the family. It tries the names in order and uses the first family that can load every range. If none can, the layer stays unchanged and the plugin reports it.

• The new family needs a face with the same name as the current one. To set family and face together, use a typography token.
• The layer must not have a missing font. Replace the missing font in Figma first.

Figma variables

A single name maps to a STRING variable. A list of two or more names is left out of the sync with the reason “A Figma variable holds one font, so this list of fonts was skipped. Use one font to sync it.”

Use a single name for tokens you map to variables. Keep fallback lists for code and for applying to layers.