Version 1, Update 138

Variable fonts

The Plugin API now supports variable fonts. Reading FontName on a variable font includes variationSettings with every OpenType axis the family defines. Pass those values when setting a font to override specific axes; omitted axes keep the named instance's defaults.

You can omit style when loading or applying a font. loadFontAsync({ family }) loads every style of the family. Setting a font without style lets Figma pick the named instance that best matches variationSettings.

New types

• FontVariationSettings: Axis values keyed by 4-character OpenType tag, for example { wght: 550, slnt: -10 }.
• FontNameInput: A font to apply where style is optional. Reads always return a fully populated FontName.

New methods

• figma.getFontFamilyVariationAxes(family): Returns the axis tags a variable font family exposes, or null for a static family.

Updated types

• FontName: Added optional variationSettings. Present when reading a variable font; omitted for static fonts.

Updated properties and methods

• fontName: Includes variationSettings when reading a variable font. Accepts FontNameInput when writing.
• loadFontAsync(): Accepts FontNameInput. Omitting style loads every style of the family.
• setRangeFontName(): Accepts FontNameInput, including variationSettings and an omitted style.