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.

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.
Method 2: Image sequence on canvas (recommended)
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
| Method | Smoothness | File weight | Difficulty |
|---|---|---|---|
| currentTime | Poor backward | Low (or high if all-keyframe) | Easy |
| Image sequence | Excellent | Medium, tunable | Medium |
| WebCodecs | Very good | Low | Hard |
Making any method production-ready
- Add smooth wheel scrolling with Lenis.
- Show a poster image first for fast paint.
- Test on a mid-range phone, not only a laptop.
- Provide a reduced-motion fallback.
- Follow the scroll animation performance guide.
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.
- Product landing page. Animate a product turning or assembling as each section of text appears.
- Portfolio or showcase intro. A short scene behind the typography sets the tone before the work appears.
- Background transition. A graphic or photo sequence changes as the visitor moves between sections.
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.