Components · Create a component
Documentation

Create a component

Turn layers into a reusable component. Every instance follows edits to the original.

A component is a part you build once and reuse: a list row, a card, a particle, a button. Each copy, called an instance, has its own start time, speed and play mode, and every instance follows when you edit the component. Components keep big scenes small and consistent, and they export as real components to React and SwiftUI.

Make one

  1. Select the layers (or a group) that make up the part.
  2. Press ⌥⌘K, or choose Stage → Create Component, or click Create component in the selection bar. In the timeline, right-click a lane → Create Component (or Create Component from 3 Layers).
  3. The layers become a component, and one instance takes their place. Timing is kept: the instance starts at the first keyframe. A notice says “Row is a component now — double-click it to edit every copy”.
  4. Duplicate the instance (⌘D) or place more from the library.
Create Component from a selection

A single plain layer names the component after itself; a group keeps its own name. Instances are marked in magenta (on the stage, in the timeline and in the inspector), so you can tell them apart from plain layers at a glance.

Component or group?

GroupComponent
CopiesIndependent; editing one doesn't change othersEvery instance follows the component
TimingChildren use scene timeEach instance has its own clock (start, speed, play mode)
Per-copy differencesAnythingProps and variants
ExportsFlattenedReact and SwiftUI components, Lottie precomps

Detach an instance

Stage → Detach Instance (also in the selection bar's instance menu and the lane menu) turns an instance back into plain layers, with its timing baked in. The component stays in the library.

Works with

Troubleshooting

If this happensTry this
“Select the layers to turn into a component”Nothing is selected. Select layers on the stage or in the timeline first.
The instance jumped in timeIt starts at the first keyframe of the selection. Set Start in the Instance section.