On this page
Quick steps
Select the layer
Select the frame, group or shape you want to reuse. A frame with auto layout is the usual starting point for buttons, cards and inputs.
Create the component
Press ⌥⌘K on Mac or Ctrl+Alt+K on Windows, click Create component in the right sidebar, or right-click and choose Create component.
Name it
Double-click the layer name and give it a clear name. A consistent pattern like Button/Primary makes it easy to find in Assets search.
Place an instance
Open the Assets panel with ⌥2 on Mac or Alt+2 on Windows and drag the component onto the canvas. That copy is an instance.
Add properties
Select the main component and use the Properties section in the right sidebar to add boolean, text or instance swap properties, so instances can change without detaching.
Create component keyboard shortcut
| Action | Mac | Windows |
|---|---|---|
| Create component | Mac⌥⌘K | WindowsCtrlAltK |
| Detach instance | Mac⌥⌘B | WindowsCtrlAltB |
| Go to main component | Mac⌃⌥⌘K | WindowsCtrlAltShiftK |
| Quick insert (place or swap a component) | Mac⇧I | WindowsShiftI |
| Open the Assets panel | Mac⌥2 | WindowsAlt2 |
If ⌥⌘K does nothing, check that you have edit access and that your keyboard layout matches the one set in Figma. Default shortcuts assume US QWERTY. More on that in Figma shortcuts not working.
How to create multiple components at once
Select several layers, open the menu next to the selection name at the top of the right sidebar, and choose Create multiple components. Figma makes one component per frame, group, boolean or path in the selection. Use it when you have a sheet of icons: one action turns 40 icons into 40 components. It works on any plan. Rename the layers before you run it, so the components are easy to find in Assets later.
Why is my layer purple in Figma?
Figma's help center says you can identify components in the Layers panel by the purple Component icon. Instances are marked in the same colour in current versions of Figma, so a purple layer is almost always a component or an instance of one. If a layer turned purple right after you pressed a shortcut, you probably created a component by accident. Undo right away, or see how to detach an instance for the longer workaround.
How to add an instance in Figma
- Assets panel: press ⌥2 / Alt+2, find the component and drag it onto the canvas.
- Quick insert: press ⇧I / Shift+I, search by name and place it.
Components from another file show up in Assets only after that file is published as a library and added to your file. If they don't appear, work through Figma library not showing.
What changed in the new Figma UI
In the current UI, the Create component button sits in the right sidebar next to the selection name, and Create multiple components lives in the menu beside it. The ⌥⌘K / Ctrl+Alt+K shortcut still works. Component properties now include five types: Boolean, Text, Instance swap, Variant (component sets only) and Slot, which rolled out from March 2026 (open beta). See Figma slots for the newest one.
Main component vs instance
Edit the main component and every instance updates. Edit an instance and you create an override that only affects that copy. Some overrides aren't possible on an instance at all: layer order, position, constraints and text layer bounds. Those have to change on the main. To undo your own overrides on an instance, open More actions next to the component name in the right sidebar and choose Reset, then reset one property or all changes.
If you delete a main component, its instances stay. Select one of them and click Restore component in the right sidebar to bring the main back.
Turn one component into a set of variants
States of the same thing, like a button's Default, Hover and Disabled looks, belong together as variants in one component set. Once the set exists, select a variant and press ⌘D / Ctrl+D to add another, then change its property values, such as State=Hover, and edit what differs. The variants guide covers the rest.
If you edited an instance and want the main to match, select the instance and use Push changes to main component. It only works when the main is in the same file, not for library or nested components.
Document the component once it exists
A component nobody can read gets detached. Once it has properties, a spec sheet next to it helps the next designer and the developer: anatomy, spacing and a table of each property with its values. Autospec, our plugin (free to start), generates that frame from the selected component. The full approach is in how to make Figma design specs.
Next steps: add component properties so instances stay flexible, then publish a library to share the component across files.
Ranked listThe best Figma plugins for design systems in 2026Frequently asked questions
What is the shortcut to create a component in Figma?
⌥⌘K on Mac and Ctrl+Alt+K on Windows. You can also click Create component in the right sidebar or right-click the layer and choose Create component.
Can I create components on the free plan?
Yes. Creating components works on any plan for anyone with edit access to the file. Publishing them as a shared library is what needs a paid plan.
How do I turn a component back into a normal layer?
There's no Remove component command. Undo right after creating it, or place an instance, detach it with ⌥⌘B / Ctrl+Alt+B, and delete the main component.
Why is a layer purple in Figma?
Purple marks components. Figma's help center points to the purple Component icon in the Layers panel as the way to spot them. Instances use the same colour in current versions, so a purple layer is usually a component or an instance.
More in Components & variants
- How to Generate All Component Variants in FigmaFigma shows only the variants you draw. Here's how to lay out every combination of variant, boolean and nested props as a matrix, by hand or with Instancer.
- How to Make a Skeleton Loader in FigmaHow to design a skeleton loader in Figma: grey blocks with auto layout, a component with variants, a Smart Animate shimmer, and a plugin that converts frames.
- How to Add Properties to a Figma ComponentAdd boolean, text, instance swap, variant and slot properties to a Figma component, link them to layers, and fix 'not used within component' warnings.
- How to Detach an Instance in Figma (and Remove a Component)Detach a Figma instance with ⌥⌘B or Ctrl+Alt+B. Why Detach is missing, how to detach a nested instance, and how to turn a main component back into a frame.
- Why Are My Nested Components Not Working in Figma?Expose nested instance properties in Figma, fix 'components can't contain instances of themselves' and the swapped-with-parent error, and see what can't change.
- How to Swap an Instance in FigmaSwap a Figma instance from the Instance menu, with Quick insert (Shift+I) or by Alt-dragging a component onto it. Plus go to main, reset and restore shortcuts.
- How to Add a Slot to a Figma ComponentAdd a slot to a Figma component with Convert to slot (⌘⇧S or Ctrl+Shift+S) or Wrap in new slot. Settings, limits, and when to use slots vs instance swap.
- How to install Figma pluginsFigma plugins don't need installing: open one from the Community or run it inside a file. Steps for Figma Design, Dev Mode, FigJam, Slides, saving and admins.
- Figma plugins not working? How to fix itFigma plugins not loading, missing or greyed out? Check your seat and edit access, org approval, network blocks and cache. A step-by-step checklist that works.
- Figma plugin vs widget: what's the difference?A Figma plugin runs for one person and closes when done. A widget is an object on the canvas everyone can see and use. When to pick which, with examples.
- How to Export Figma Variables to JSON (and CSS, Tailwind or CSV)Export Figma variables to JSON natively, convert them to CSS or Tailwind with Style Dictionary, and move variables between files with Variable Master.
