FINDING YOUR DIRECTION

0%
← Scrollhaus Journal

AI Website Guides · Published · Updated · 5 min read

Scroll Video Animation Website: 3 Ways to Build It (2026)

A scroll video animation plays footage as the visitor scrolls. There are three ways to build it, and they differ sharply in smoothness and weight. This guide compares them with code so you can pick the right one.

Published by Amanjot Singh, founder of Scrollhaus. AI-assisted editorial work; product context, sources and corrections are documented in our editorial methodology.

A video scrubbed by scroll on an animated website
Scrollhaus Journal · AI Website Guides

Disclosure: ScrollHaus publishes this guide. Technique descriptions come from public documentation of the libraries and browser APIs named, and the live examples are ScrollHaus websites you can scroll yourself.

What is a scroll video animation?

Scroll video animation, also called scroll-linked video or video scrubbing, ties playback to scroll position. Scroll down and the footage plays forward. Scroll up and it plays back. It is the engine behind many cinematic landing pages.

Method 1: Set video.currentTime on scroll

The simplest approach is mapping scroll progress to video.currentTime.

const v = document.querySelector('video');
addEventListener('scroll', () => {
  const p = scrollY / (document.body.scrollHeight - innerHeight);
  v.currentTime = p * v.duration;
}, { passive: true });

Pros: tiny code, one small file. Cons: video is compressed with keyframes, so seeking, especially backward, is slow and visibly stutters unless you re-encode with a keyframe on every frame, which makes the file large.

Extract the video to frames and draw them to a canvas by scroll progress. Every frame is independent, so playback is smooth in both directions. File size is controlled with WebP, staged loading and a smaller mobile set. This is what our own websites use, and the code is in the image sequence canvas tutorial.

ffmpeg -i hero.mp4 -vf "fps=24,scale=1920:-2" -c:v libwebp -quality 82 frames/f_%04d.webp

Method 3: WebCodecs decoding

The WebCodecs API lets JavaScript decode video frames directly to a canvas. It avoids a large folder of images but needs more code, careful memory handling and a fallback for browsers or devices without full support. It suits advanced teams, not a first build.

Comparison

MethodSmoothnessFile weightDifficulty
currentTimePoor backwardLow (or high if all-keyframe)Easy
Image sequenceExcellentMedium, tunableMedium
WebCodecsVery goodLowHard

Making any method production-ready

Where scroll video works on a web page

A website scroll animation built from video suits pages where one visual carries the story. You create the footage once, in a studio, in 3D software or with an AI tool, and the site lets a user control it by scrolling.

Tools

GSAP ScrollTrigger is the common choice for animation on scroll with custom code. WordPress has a plugin for scroll-controlled video, and visual builders offer an interactive element you configure with a click. For web design inspiration, explore a collection such as Awwwards and watch how each site handles the screen on a phone.

Keep the motion tied to content. A button, a heading and a clear next step should remain visible while the video plays. If the picture is only decoration, a still image or a simple transition will load faster and do the same job.

Examples to scroll

Open Ice Cave, VORTA or CORNERSTONE to see scroll-driven footage that stays smooth backward and forward. For design ideas see websites with scroll animation and the full Apple-style scroll animation breakdown.

Frequently asked questions

How do I play a video on scroll?

Map scroll progress to video.currentTime, or for smoother results extract frames and draw them to a canvas by scroll progress.

Why does my scroll video stutter when scrolling up?

Video keyframes make backward seeking slow. Use an image sequence on canvas, or re-encode with a keyframe on every frame.

What is the best method for scroll video animation?

An image sequence drawn to a canvas is the most reliable for smoothness in both directions across browsers.

How big are image sequences?

A 6 second clip at 24 fps is about 144 WebP frames. Staged loading and a smaller mobile set keep the first view fast.

Does the WebCodecs API work everywhere?

Support is strong in modern Chromium browsers but varies elsewhere, so keep a fallback.

Browse Scrollhaus website designs and build resources →

Need help with a template, account, or project? Email admin@scrollhaus.ai.