Variable Migration Tool

About this plugin

Migrate variables, text styles, and effect styles when transitioning between design systems or updating libraries. Use JSON mapping files to replace outdated design system references across selected elements, a section, or an entire page.Key FeaturesVariables and styles — migrate variables, text styles, and effect stylesFlexible scope — update selected elements, the surrounding section, or the entire pageBatch migration — load multiple mapping files and migrate everything in one runAutomatic library import — required variables and styles are imported from published librariesSafe operation — only items explicitly included in the mapping are changedPerfect forMigrating between design system versionsTransitioning to a new token or style libraryBulk updating outdated variables and stylesKeeping product files aligned with the latest design systemUpload your JSON mappings, choose the migration scope, and run the plugin — it handles the rest.JSON Format Example{ "variables": [ { "old": { "key": "old-variable-key", "name": "comp/button/primary" }, "new": { "key": "new-variable-key", "name": "button/primary" } } ], "textStyles": [ { "old": { "key": "old-text-style-key", "name": "Old Library/Body/M" }, "new": { "key": "new-text-style-key", "name": "New Library/Body/M" } } ], "effectStyles": [ { "old": { "key": "old-effect-style-key", "name": "Old Library/Shadow/M" }, "new": { "key": "new-effect-style-key", "name": "New Library/Shadow/M" } } ]}About KeysThe key is Figma’s unique identifier for a published variable or style. Source and target keys can be obtained from the corresponding design system libraries through the Figma Plugin API, REST API, or your library’s mapping export tool.A key is not the variable or style name and not a node ID. The name fields are optional and are included only to make mapping files easier to read. Migration rules are matched using key.