Figma for Product Teams · 20 min · 130 XP
Components and variants
Main components, instances, overrides and variants, and why a swap sometimes loses your text.
A main component is the definition. An instance is a copy that keeps a link back to it: change the main, and every instance everywhere updates. That link is the entire value, and the most common mistake in a Figma file is quietly breaking it.
On an instance you can change some things without breaking anything. These are overrides: text content, fills and strokes, visibility of a layer, and swapping a nested instance. What you cannot do is add or delete layers. For that, Figma offers Detach instance, which turns the copy into ordinary layers and severs the link for good. A detached instance will never receive another update. Treat detaching as a last resort, and if you find yourself doing it often, the component is missing a property.
Variants collect related components into one component set. Instead of Button/Primary/Large, Button/Primary/Small, Button/Ghost/Large scattered across the canvas, you get one component with properties (Type: Primary | Ghost, Size: Large | Small) and a dropdown on every instance. Figma builds the properties from the slash-separated names when you combine them, which is why naming matters before you combine, not after.
Button (component set) Type=Primary, Size=Large Type=Primary, Size=Small Type=Ghost, Size=Large Type=Ghost, Size=Small On an instance the designer sees two dropdowns, not sixteen components.
The override rule that bites everyone: when you switch an instance from one variant to another, Figma carries overrides across by matching layer names. If the label is called Label in one variant and Text in the other, your carefully typed text resets to the default. Keep layer names identical across every variant in a set.
Do it in Figma: build a button, make Primary and Ghost versions, name the text layer differently in each on purpose, combine them as variants, then type a label on an instance and switch variants. Watch it reset. Rename both layers to Label and try again.
Loading your workspace…