Course contentsShow
← Web Development
Lesson 2568 of 2,98246. Animation LibrariesFree lesson

Parent-Child Animation Orchestration

Stagger and sequence child animations automatically using variant propagation and orchestration props.

Parent-Child Animation Orchestration

What you'll learn: How to automatically stagger and sequence child animations by propagating variants from parent to child components in Framer Motion.


When you define variants on a parent motion component, Framer Motion can automatically orchestrate the animation timing of all child motion components that share variant names. This means you don't manually trigger each child — the parent conducts the entire animation like a symphony conductor.

How Propagation Works

When a parent component switches variants (say, from "hidden" to "visible"), it broadcasts that variant name down the tree. Any child motion components with matching variant names respond automatically. You control when children animate relative to the parent using orchestration props in the parent's transition:

  • staggerChildren – Delays each child's start by a fixed amount (in seconds)
  • delayChildren – Delays all children by a set amount before they begin
  • staggerDirection – Animates children forward (1) or backward (-1)

Think of It Like a Domino Effect

The parent tips the first domino (changes variant), and the orchestration props control the spacing and timing of each subsequent domino falling.

Example Structure

const containerVariants = {
  hidden: { opacity: 0 },
  visible: {
    opacity: 1,
    transition: {
      staggerChildren: 0.2,
      delayChildren: 0.3
    }
  }
};

const itemVariants = {
  hidden: { y: 20, opacity: 0 },
  visible: { y: 0, opacity: 1 }
};

<motion.ul variants={containerVariants} initial="hidden" animate="visible">
  <motion.li variants={itemVariants} />
  <motion.li variants={itemVariants} />
  <motion.li variants={itemVariants} />
</motion.ul>

The parent ul waits 0.3s, then each li animates in sequence with a 0.2s stagger — zero manual timing code required.

Key Takeaway:
Use variant propagation with staggerChildren and delayChildren to orchestrate child animations declaratively, letting the parent control timing for the entire animation hierarchy.