Font family

Token typePartial$type: fontFamily2026-07-27

A font family name, or a fallback stack.

Value format

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

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

Both forms are valid DTCG: a single string, or an array of strings for a fallback stack.

What you can type

Input	Stored as
`Inter`	`"Inter"`
`Inter, Helvetica, sans-serif`	`["Inter", "Helvetica", "sans-serif"]`

A comma in the input automatically produces an array — you do not write JSON brackets yourself.

Applying to Figma

Default target: Font family. Text layers only; other layer types are skipped.

The plugin tries a list of common style names — Regular, Normal, Roman, Book, Medium, Light, Bold — until one of them loads for that family. Mixed-font text layers are handled per styled segment.

A fallback stack cannot be applied

Applying a token whose value is an array does not work. The array is joined into the single string "Inter,Helvetica,sans-serif", which is not a real Figma font, so the font fails to load and the layer is left unchanged.

Array values still author, validate, export, and sync correctly — the limitation is only in the apply step. If you need to apply a family to layers, keep the token a single string, or use a typography token, whose applicator does walk the fallback list properly.

Notes and limits

The font must be available in Figma. A family Figma cannot load produces “Failed to load font …” and the layer is skipped.
To set family and weight together, prefer a typography token — it resolves the family/weight pair as one unit instead of two independent applies.