ai.to.design is now free.No account needed.Install now →
Docs menu

MCP Tools

set_instance_variant

Switch the variant of a component instance.

Sets variant properties on an INSTANCE node, e.g. { Size: 'Large', State: 'Hover' }, swapping it to the matching variant of its component set. Use get_component_metadata first to discover the available properties and values.

Parameters

NameTypeRequiredDescription
instanceNodeIdstringRequiredThe Figma node ID of the INSTANCE to update
variantPropertiesobjectRequiredProperty-value pairs to set, e.g. { Size: 'Large', State: 'Hover' }

Example prompt

Try asking: Switch every button in the pricing section to the Large size.

Tips

  • Property names and values are case-sensitive — copy them from get_component_metadata.
  • Only the properties you pass change; the others keep their current value.