Extended variable collections (Enterprise only)​

Extended variable collections enable theming for variables. When you extend a collection, the extension inherits all modes and variables from its parent collection. You can then override variable values in the extended collection to create theme-specific variations while maintaining a single source of truth.

New type​

• ExtendedVariableCollection: A variable collection that extends another collection

New methods​

• figma.variables.extendLibraryCollectionByKeyAsync(collectionKey, name): Create an extended collection from a library or local variable collection
• variableCollection.extend(name): Create an extended collection from a local variable collection
• variable.valuesByModeForCollectionAsync(collection): Get variable values for a specific collection, including overrides in extended collections
• variable.removeOverrideForMode(extendedModeId): Remove an override for a specific mode
• extendedVariableCollection.removeOverridesForVariable(variableId): Remove all overrides for a variable

New properties​

• extendedVariableCollection.variableOverrides: A map of all overridden variable values in the extended collection
• mode.parentModeId: For modes in extended collections, references the corresponding mode in the parent collection

Updated behavior​

• variable.setValueForMode(modeId, value): When the modeId belongs to an extended collection, the value will be set as an override on the extension

For examples and more details, see Working with Variables.

New layout options for grid​

• Frames with layoutMode 'GRID' now support 'HUG' for layoutSizingHorizontal and layoutSizingVertical.
• Frames with layoutMode 'GRID' also support 'HUG' as a GridTrackSize type in the row and column sizes
• Frames with layoutMode 'GRID' now support values other than 1 for 'FLEX' sized tracks in gridRowsSizes and gridColumnsSizes. This corresponds to the fr unit in CSS Grid
• Note: in Figma Design, when creating a new grid, the container and all rows and columns are automatically set to HUG, but in the Plugin API, new grids are FIXED and their tracks are FLEX.
• Breaking change: previously, calling the GridTrackSize setters with a value would set the track to 'FIXED' if it was previously set as 'FLEX'. Now, the type will only be automatically set to 'FIXED' if the track was previously set to 'HUG'

Instance method deprecation​

• The resetOverrides method on InstanceNode is deprecated in favor of removeOverrides. This is a change in method name only.

Plugins in Buzz​

Figma Buzz now supports plugins! With the new API features, you can enable users to create, customize, and manage marketing assets like social posts, digital ads, and more at scale.

New:

• Figma's Plugin API typings now support Figma Buzz.
• figma.editorType can now return buzz when a plugin is running in Figma Buzz.
• figma.buzz provides access to the Buzz API with methods for creating and managing media assets.
• figma.buzz.createFrame() creates frames optimized for the canvas grid layout.
• figma.buzz.getBuzzAssetTypeForNode() and figma.buzz.setBuzzAssetTypeForNode() allow you to work with 42+ predefined asset types for platforms like Instagram, LinkedIn, Twitter, and Facebook.
• figma.buzz.getTextContent() and figma.buzz.getMediaContent() extract dynamic content fields from templates for easy customization.
• figma.buzz.smartResize() intelligently resizes assets for different platform requirements while preserving design integrity.
• figma.viewport.canvasView can be used to toggle between grid view or single-asset view.
• figma.currentPage.focusedNode identifies the asset currently focused on in the interface.
• figma.getCanvasGrid() returns the canvas grid, a 2D representation of assets within the canvas.
• figma.setCanvasGrid() is used to reorder assets in the grid.
• figma.createCanvasRow() creates a new row in the canvas grid.
• figma.moveNodesToCoord() moves nodes to specific positions in the canvas grid.

For more information, see the Working in Buzz guide.

• Added support for fontStyle in getStyledTextSegments()

• Added grid gap types to VariableBindableNodeField
• Added grid types to AnnotationProperty

• Added the visible property to the Noise and Texture effect types.
• Added the boundVariables property to Noise and Texture effect types to prevent validation errors on write. Note that binding variables for Noise and Texture effects is not yet supported.
• Added a new Glass effect type in beta. Note that the effect is only supported on Frames at this time, and binding variables is not yet supported.
• Fixed GridTrackSize to properly handle value as optional.

Added documentation for figma.ui.getPosition().

Added support for Grid layout properties on grid containers and children.

Grid Containers​

• gridRowCount
• gridColumnCount
• gridRowGap
• gridColumnGap
• gridRowSizes
• gridColumnSizes
• appendChildAt

Grid Children​

• gridRowSpan
• gridColumnSpan
• gridRowAnchorIndex
• gridColumnAnchorIndex
• gridChildHorizontalAlign
• gridChildVerticalAlign
• setGridChildPosition

• Added missing stroke cap types to StrokeCap including "DIAMOND_FILLED", "TRIANGLE_FILLED", and "CIRCLE_FILLED"
• Added the color property to the Noise effect type

New:

• Type definitions now ship with docstrings, so you can view Plugin API documentation alongside your code in IDEs such as VSCode.

Bug fixes:

• Fix the type definition for InteractiveSlideElementNode to include a clone() method.
• Fix the type definition for PatternPaint to include visible, opacity and blendMode properties.

Bug fixes:

• The type definition for CodegenPreferences.unit now uses uppercase string values instead of lowercase string values