Packages

framer-motion

14.7.1 · 27 Oct 2026MIT45.3M / weekRepositoryHomepagenpmAtom feed

Upgrading framer-motion from 7.6.19 to 14.7.1

499 releases in betweennotes for 448

Other targets from 7.6.19Newest 7.x7.10.3
9.0.0, 8.0.0 have no release note on GitHub or in the repository's changelog, so their breaking changes are missing from the counts below; the migration guide covers them.
10+
changes to make
0
advisories fixed
145+
new
475+
fixes

Counted from 448 of 499 release notes. Advisories are counted from the advisory database, in full.

Start here

Before you upgrade

Tick each one off as you go
  • breaking13.2.0
  • breaking12.23.19
  • breaking12.8.0
  • breaking12.5.0
  • breaking11.17.0
  • breaking11.0.1
  • breaking10.0.0
  • breaking10.0.0
  • deprecated12.22.0
  • deprecated12.1.0

Release by release

  1. 14.7.1

    27 Oct 20261 fix
    • fixed

      Demote transforms to CPU when interrupted by layout animations.

  2. 14.7.0

    27 Oct 20265 new · 12 fixes
    • new

      animate: Mutable timeline sequences.

    • new

      animate: Relative label offsets for timeline sequences.

    • new

      useScroll: Returns scrollXLength and scrollYLength.

    • new

      Reorder: Add LazyMotion-compatible import.

  3. 14.6.0

    22 Oct 20263 new · 8 fixes
    • new

      Reorder: Grab-and-move keyboard reordering.

    • new

      processFrame: Manually process the frameloop at t.

    • new

      stepFrames: For tests, synchronously advance frameloop time by duration.

    • fixed

      Improved tree-shaking.

  4. 14.5.0

    21 Oct 20262 new · 5 fixes
    • new

      scopeMotion/useScopeMotion: Scope animations and gestures to set default transitions, specify root elements, match media, and easy cleanup.

    • new

      Reorder: Pass moved to onReorder as second argument.

    • fixed

      drag: With direction lock, apply the move that sets the lock. Before, a fast drag released in that frame didn't move.

    • fixed

      press: Improve cleanup of keyboard accessibility events.

    • fixed

      Reorder: Stop double-counting window scroll during drag.

    • fixed

      motion: Ensure we animate from the latest props when parent Activity is made visible.

    • fixed

      useInView: Observe ref if contents change after mount.

  5. 14.4.0

    19 Oct 20261 new
    • new

      drag: Drag gesture added to JavaScript API.

  6. 14.3.1

    19 Oct 20268 fixes
    • fixed

      AnimatePresence: Fire onExitComplete after exiting children unmount.

    • fixed

      AnimatePresence: popLayout children that don't accept ref are now popped when root component is <motion> element.

    • fixed

      Fix interpolation of axis rotate and skew transforms during shared layout animation.

    • fixed

      Fix layout animations when layout is enabled after mount.

  7. 14.3.0

    15 Oct 20262 new · 3 fixes
    • new

      stagger: New grid, from: "edges" | "random" options.

    • new

      Support for scaleZ.

    • fixed

      Fix matrix3d and other digit-named transform functions being tokenised as numbers.

    • fixed

      useSpring: Ensure when switching targets we animate to the new target on switch.

    • fixed

      Fix SVG MotionValue children being written as a children attribute.

  8. 14.2.0

    13 Oct 20261 new
    • new

      Hardware accelerated independent transforms like x, y, scaleX etc.

93 other lines we could not sort, mostly version bumps

  • Removed internal APIs restored in 13.5.1 for compatibility with framer-motion 13.0–13.4. Future removed internal APIs won't cause cross-compatibility issues since pinning internal framer-motion, motion-dom and motion-utils dependencies.

    14.0.0

  • <motion>: Fall back to the attribute in readSVGValue when computed style is empty.

    13.5.1

  • <motion>: Internal changes to animateChanges for size reductions.

    13.5.1

  • <m>: 20% smaller.

    13.5.0

  • useSpring: 10% smaller.

    13.5.0

  • scroll/useScroll: Use main thread for all offset animations.

    13.5.0

  • scroll: 44% smaller.

    13.4.4

  • useScroll: 33% smaller.

    13.4.4

  • Scroll callbacks: 50% faster.

    13.4.4

  • Removed ScrollTimeline support for JS callbacks as benchmarked no improvement over scrollInfo.

    13.4.4

1 internal line (docs, tests, tooling) left out.