# useAnimationControls > Legacy imperative controls for coordinating one or more motion components. **Source:** [https://motion.svelte.page/docs/use-animation-controls](https://motion.svelte.page/docs/use-animation-controls) --- `useAnimationControls` creates a legacy imperative controller. Pass the returned object to one or more `motion.*` components via `animate={controls}`, then call `controls.start(...)`, `controls.set(...)`, or `controls.stop()`. ```svelte Start ``` > Live example: [/examples/use-animation-controls](https://motion.svelte.page/examples/use-animation-controls) ## Sequencing `controls.start(definition)` returns a promise. If the controls are subscribed to three motion components, that promise resolves after all three components finish their animation. ```svelte ``` ## Variants Each subscribed component resolves the same variant label against its own `variants` map. This mirrors Motion's VisualElement fan-out behavior: ```svelte ``` ## API Reference ### `useAnimationControls()` Returns an `AnimationControls` object: - **`start(definition, transitionOverride?)`** — animates every subscribed component and returns `Promise`. - **`set(definition)`** — synchronously sets every subscribed component to the target's final values. Variant labels and `transitionEnd` values are resolved. - **`stop()`** — stops active subscriber animations. - **`mount()`** — internal lifecycle hook called automatically by `useAnimationControls()`. - **`subscribe(subscriber)`** — internal component subscription hook. `start` and `set` throw if called before the hook's component has mounted, matching upstream Motion's guard against render-synchronous control calls. ## Alias `useAnimation` is exported as an alias of `useAnimationControls`, matching Motion's legacy API. ## Related - [`useAnimate`](/docs/use-animate) — scoped selector-based imperative animation - [`Variants`](/docs/variants) — named animation states Based on [Motion's useAnimationControls](https://motion.dev/docs/react-use-animation-controls) API.