Rebind

#What Rebind does

Rebind replaces an instance's main component source (swapComponent) while preserving instance-level customization.

Use it when:

• an instance is Broken (main component is missing);
• an instance is Remote and must be relinked to a local component;
• you need to migrate instances to a new component source without rebuilding layouts.

Rebind is part of Instance Recovery in Inspect.

#Rebind vs Swap

• Rebind: replaces the component source of an instance.
• Swap: rebinds variables/styles while keeping the same component source.

See Swap for variable/style migration.

#Step-by-step: Rebind

1. Select an instance (or select a parent that contains broken instances).
2. Open Inspect.
3. In Instance Recovery, click:
   • Rebind for current/matching instances;
   • Rebind All for broken descendants in the selected subtree.
4. The plugin finds candidate instances on the current page.
5. In the modal, set target component by one of these methods:
   • paste Component ID;
   • paste Component Key (library key);
   • click target picker and select a COMPONENT on canvas.
6. Click Bind.

#Matching logic before modal opens

When finding matching instances:

• if source instance has a resolvable main component, matches are found by main component id/key on the current page;
• if source is broken, fallback matching uses same instance name among broken instances.

This allows bulk recovery for common broken-instance clusters.

#What is preserved

Before swap, the plugin captures and then restores:

• component property values;
• text/paint/stroke/effect overrides in the instance tree;
• visibility/opacity and selected plugin data used by recovery helpers.

Result: layout/customization is preserved as much as the target component structure allows.

#Create Component from instance

If target component does not exist yet:

1. In Rebind modal, click Create Component.
2. Plugin creates a new component from a detached clone of the instance.
3. Original instance is rebound to this new component.

Useful for fast local recovery from broken external sources.

#Limits and caveats

• Rebind requires INSTANCE_REBIND feature.
• Matching is page-scoped (current page), not full-document.
• Target must resolve to a COMPONENT (not arbitrary node).
• If required fonts are unavailable, some text restoration may be partial until fonts are loaded.

#Related sections

• Inspect Overview
• Ghost Heal
• Swap