Slots GA​

Slots were supported within the Plugin API throughout the public beta. With our GA launch of slots, we've introduced new capabilities alongside stability improvements in both Figma Design and the Plugin API.

New node type​

• SlotNode: Represents a slot within a component or instance. A slot is a child frame of a component that has freeform content editing.

New types​

• SlotSettings: Slot-specific configuration for 'SLOT'-typed component properties. Fields include stretchChildOnInsert, displayEmptyByDefault, minChildren, maxChildren, and allowPreferredValuesOnly.

New methods​

• componentNode.createSlot(): Creates a new slot node within a component.
• slotNode.resetSlot(): Resets a slot node to the original component slot content.

New read properties​

• slotNode.limitViolations: Given slotSettings are configured on the slot definition, returns any limits that the current slot instance is in violation of. Possible kinds are 'BELOW_MIN', 'ABOVE_MAX', and 'HAS_NON_PREFERRED'. Returns an empty array when within limits.

Updated types​

• ComponentPropertyType: Added 'SLOT' as a new component property type.
• ComponentPropertyOptions: Added optional description and slotSettings fields, applicable to slot properties.
• ComponentPropertyDefinitions: Added optional description and slotSettings fields for slot property definitions.

Updated methods​

• addComponentProperty(): Now supports 'SLOT' property type, including a slotSettings option for configuring slot behavior and child-count limits.
• editComponentProperty(): Now supports 'SLOT' property type with preferredValues, description, and slotSettings options.
• deleteComponentProperty(): Now supports 'SLOT' property type.

New features:

• Grid layouts now support automatic row creation, automatic item positioning, and track reordering:
  • gridAutoTracks: controls whether empty rows are removed automatically. Perfect for pairing with gridItemsPositioning below.
  • gridItemsPositioning: controls whether children automatically flow into the next available cell in row-major order, similar to CSS grid-auto-flow: row.
  • reorderRows and reorderColumns: move one or more rows or columns to a new position in the grid, returning the full set of track movements.
• The NoiseEffect and TextureEffect types now expose noiseSizeVector, allowing the noise size to be set independently along the x and y axes. The existing scalar noiseSize continues to work and now mirrors noiseSizeVector.x.
• The SectionNode now expose strokes and cornerRadius, allowing plugins to modify those values on Sections.

Bug fixes:

• Fix the type definition for SlotNode to include a clone() method.

Dev Mode: focused node in Plugin API​

Plugins running in Figma Dev Mode can now read the node currently focused in the Dev Mode focus view. The existing figma.currentPage.focusedNode property (already used in Figma Slides and Figma Buzz for the focused slide or asset) now returns that node in Dev Mode as well. See Working in Dev Mode for more on building plugins for Dev Mode.

Expanded support for Figma Draw features​

You can now use the Plugin API to view and manipulate Figma Draw features, including:

• Creating and editing text on a path nodes
• Viewing and adding transforms in transform groups
• Viewing and adding stretch brush, scatter brush, and dynamic strokes
• Modifying stroke width profiles to create custom variable width strokes or using preset stroke width profiles

We've also updated the documentation around setting pattern fills and strokes.

New types​

• TextPathStartData: Data defining the starting position of text on a path
• TransformModifier: A modifier that can be applied to a transform group
• ComplexStrokeProperties: Stroke properties describing stretch brushes, scatter brushes, and dynamic strokes
• VariableWidthStrokeProperties: Points that define the width profile of variable width strokes

New methods​

• figma.createTextPath(node, startSegment, startPosition): Create a text on a path node from a vector node.
• figma.transformGroup(nodes, parent, index, transformModifiers): Wrap nodes in a transform group with specified transform modifiers.
• figma.loadBrushesAsync(brushType): Load the first-party brushes of the specified type (stretch or scatter).
• node.setFillsAsync(fills): Supports setting pattern fills.
• node.setStrokesAsync(strokes): Supports setting pattern strokes.

New properties​

• textOnPathNode.textPathStartData: Gets and sets the starting position data for text on a path node.
• transformGroupNode.transformModifiers: Gets and sets the transform modifiers applied to a transform group.
• node.complexStrokeProperties: Gets and sets the complex stroke properties (brush or dynamic stroke properties) of a node, if any.
• node.variableWidthStrokeProperties: Gets and sets the variable width stroke properties of a node, if any.

• Added a rootVariableCollectionId property to extended collections that return the node ID of the top-most ancestor
• Fixed plugin manifest documentation to list slides and buzz as valid editorType values

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()