Swap Main Component - Local or Remote - Keep instances

About this plugin

Ever tried to swap dozens of components across a design file, only to watch all your carefully crafted text overrides, variant states, and bound variables disappear? Or maybe you're migrating a complete Design System and need to safely replace hundreds or thousands of instances across multiple pages?Swap Main Component (Batch Edition) takes the anxiety out of component migrations. It analyzes your source and replacement components before making any changes, pairs them automatically from your canvas selection, and guarantees that your overrides, text content, and variable bindings remain intact.✨ Why use this plugin?⚡ Instant Canvas Auto-Pairing: No manual mapping required. Simply select your old and new components or instances on the canvas, click "Auto-pair from selection", and the plugin automatically identifies versions, matches names, and configures the swap queue in seconds.🛡️ 100% Override & Variable Preservation: Keeps your custom text, boolean toggles, nested instance swaps, and bound design tokens/variables completely intact.🔍 Pre-flight Compatibility Audit: Don't guess if a swap will break your design. The plugin runs deep structural and property checks before swapping, alerting you if properties differ, values will reset, or if components are incompatible.📦 True Batch Processing: Replace multiple component families at the same time in a single click instead of doing them one by one.🚀 High-Performance Scopes (Selection, Page, File): Engineered with native chunking and memory-safe scanning. Swap instances across massive files with dozens of pages and complex structures without freezing or crashing Figma.🛑 Live Cancel & One-Click Undo: Full control over your changes. Cancel long-running batch operations at any time with instant auto-revert, or use the multi-level Undo stack if you change your mind.👁️ Non-Destructive Preview: Instantly zoom and highlight all candidate instances across your canvas before applying any change.🌗 Native Adaptive Interface: Automatically adapts to Figma Light Mode & Dark Mode with a dynamic, compact window that scales with your queue.🚀 How to use itSelect your components on the canvas: Select the instances or main components you want to replace alongside the new target components.Open the plugin & Auto-Pair: Click "Auto-pair from selection". The plugin instantly detects matching pairs, identifies source vs target, and populates your queue.Review & Analyze: Check the compatibility status (Ready, Warning, or Blocked). Click "Analyze" for a deep audit of layer hierarchies and variant properties.Choose your Scope:Selection: Apply only to currently selected layers.Page: Replace all matching instances across the active page.File: Safely scan and update instances across your entire Figma document.Click "Replace all"! Watch the live progress bar update each component in real time.💡 Perfect for:Design System Migrations: Seamlessly transition from v1 to v2 components across entire projects without losing production copy.Library Swaps: Move from local components to a shared Team Library (or between different external UI kits).Design Cleanup: Replace deprecated, legacy, or placeholder components across complex multi-page files.Rebranding & Theming: Update core UI building blocks across design files in minutes instead of days.Stop doing tedious, risky manual swaps. Let Swap Main Component handle your migrations safely and effortlessly!