figma_instantiate_component
Creates a Figma component instance from design system identifiers, using both componentKey and nodeId to support published and local components.
Instructions
Create an instance of a component from the design system.
CRITICAL: Always pass BOTH componentKey AND nodeId together! Search results return both identifiers. Pass both so the tool can automatically fall back to nodeId if the component isn't published to a library. Most local/unpublished components require nodeId.
IMPORTANT: Always re-search before instantiating! NodeIds are session-specific and may be stale from previous conversations. ALWAYS search for components at the start of each design session to get current, valid identifiers.
VISUAL VALIDATION WORKFLOW: After instantiating components, use figma_take_screenshot to verify the result looks correct. Check placement, sizing, and visual balance.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nodeId | No | The node ID from search results. ALWAYS pass this alongside componentKey - most local components need it. | |
| variant | No | Variant properties to set (e.g., { Type: 'Simple', State: 'Active' }) | |
| parentId | No | Parent node ID to append the instance to | |
| position | No | Position on canvas (default: 0, 0) | |
| overrides | No | Property overrides (e.g., { 'Button Label': 'Click Me' }) | |
| componentKey | No | The component key from search results. Pass this WITH nodeId for automatic fallback. |