You can now use the Plugin API to read and update Motion animation data, including animation styles, timelines, animations, and manual keyframe tracks.

New methods​

• figma.motion.figmaAnimationStyles(): Read the Motion animation styles available in a file.
• figma.motion.physicalSpringToNormalized(): Convert physical spring parameters to Motion's normalized bounce value from 0 to 1.
• applyAnimationStyle: Apply a Motion animation style to a node.
• removeAnimationStyle: Remove an applied Motion animation style from a node.
• applyManualKeyframeTrack: Apply or replace a manual Motion keyframe track on a node.
• removeManualKeyframeTrack: Remove a manual Motion keyframe track from a node.
• setTimelineDuration: Update the duration of a Motion timeline.

New properties​

• animationStyles: Read the Motion animation styles currently applied to a node.
• animations: Read all Motion animation keyframes on a node, including keyframes created by animation styles and manual keyframe tracks.
• manualKeyframeTracks: Read the manual Motion keyframe tracks bound to a node.
• timelines: Read the Motion timelines that contain a node.

Shaders in the Plugin API​

You can now use the Plugin API to discover, import, and apply shaders.

New methods​

• figma.listAvailableShaders(): List every shader available to the current file — shaders already in the file, shaders from subscribed libraries, and the user's owned shaders.
• figma.importShaderById(): Materialize a shader into the current file so it can be applied.

New types​

• Shader, ShaderPropertyDefinition, and ShaderPropertyValue describe a shader and its configurable properties.
• ShaderEffect and ShaderPaint are new { type: 'SHADER' } members of the Effect and Paint unions. Apply a shader by setting one of these on a node's effects, fills, or strokes, and configure it through the properties map.

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.

• 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.

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

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.

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.

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.

• 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.

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

• 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.

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

• Text path node type
• Transform group node type
• Texture and Noise effect types
• Progressive blur effect type
• Pattern paint type

The node types and properties in beta can be used with Figma Design and Figma Draw.

For more details, see:

• Codegen plugins
• figma.codegen.on callback

We've updated our Plugin API to support Annotation Categories, enabling developers to create organized and structured annotations with their plugins. Plugin API users can now:

• Initialize and manage Annotation Categories at the file level
• Create Categories with custom labels and colors.
• Read existing Annotation Categories defined for a file
• Assign a new Category to an Annotation for better organization
• Remove, add, and edit Categories as needed

This update builds upon our previous annotations support, giving you more control over how annotations are categorized and displayed in your plugins.

For more information, see:

• Annotation Categories
• Annotation Category Colors
• figma.annotations