Version 1, Update 121

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.