Capture support guide
Most fixes below live in Advanced capture options inside the Generate window. Change an option, hit ↻ Refresh preview, and generate again.
The scroll looks choppy
Mockvid automatically adapts the capture to the site's content, so animated pages come out smooth on their own. Heavily animated sites can take a bit longer to capture; that's expected. If the result still doesn't convince you, open Advanced capture options in the Generate window:
- Set Smoothness to Maximum: it forces the smoothest capture on any site, animated or not. It takes noticeably longer, but it is the single most effective option when the motion doesn't satisfy you. Auto (the default) applies it only to sites detected as animated, and Light is the fastest capture.
- Set Easing to Linear: it gives the most constant, even scroll.
- Outside that panel, in the bar under the preview: increase the speed, since a faster scroll reads as smoother in the final video.
Reveal animations already played / everything is visible from the start
Many sites animate elements in as you scroll ("reveals"). These usually fire once. If a capture shows everything already revealed, the page was scrolled before recording, typically by the Lazy-load pre-scroll option.
- Pre-scroll is off by default precisely to preserve reveals. If you switched it on, turn it off and refresh the preview.
Images are missing or blank
Some sites only load images when they enter the viewport (lazy-loading). Mockvid pre-loads common patterns without scrolling, but a few JavaScript-heavy implementations resist.
- Turn on Lazy-load pre-scroll: the page is scrolled once before recording, forcing every image to load. Trade-off: one-shot reveal animations will have played already (see above). Pick whichever matters more for that site.
- Increase Wait before recording to give heavy pages a few extra seconds to settle.
A cookie banner or reCAPTCHA badge shows in the video
Hide cookie banner and Hide reCAPTCHA badge are on by default and handle the vast majority of consent popups and floating badges. If a stubborn overlay survives, hide it yourself with Custom CSS injection, e.g. .my-popup { display: none !important; }.
The site shows in the wrong language
Captures run from our servers, so sites that adapt to the visitor's browser language will default to English. Use the Site language option to request a specific language. It is sent as the browser's Accept-Language.
- Limitation: sites that pick the language from the visitor's IP location (rather than browser settings) may ignore it. If so, capture a language-specific URL directly (e.g.
example.com/fr/).
The scroll doesn't move, or only part of the page scrolls
Sites using smooth-scroll libraries (Locomotive, Lenis), full-page sliders or internal scroll containers need a different scroll technique. Mockvid detects the right one automatically, and the Generate window shows a badge when a special method is picked.
- If the automatic choice misses, set Scroll method manually: Native, Container or Wheel. Wheel works best on smooth-scroll libraries.
The capture fails or the page looks broken
Most failures come from the site refusing the visit. Find your case below; if nothing works, the plan B at the end always does.
"Could not reach the site", but it opens fine for you
Some hosting providers and firewalls block visits that come from servers rather than from people, even when the site opens normally in your browser. Mockvid films your site from its own server, so the firewall can turn it away before the page loads.
- Ask whoever manages the site or its hosting to allow Mockvid's address on their firewall (often called adding it to the allowlist or whitelist): 167.233.136.160.
- Once it's allowed, generate the mockup again. Nothing else changes on your site.
The site blocks automated browsers
Bot protection, login walls and paywalls can stop the capture or make the page render wrong.
- Check the page is publicly reachable without logging in.
- If it's your site or a client's, let Mockvid through its protection. On Cloudflare, add an IP Access rule with the Allow action, or a WAF custom rule with the Skip action, for 167.233.136.160. Other firewalls have a similar allowlist. You can remove the rule once your videos are done.
- If only the mobile capture is blocked, Mockvid keeps your desktop video and the phone shows Mobile view not available. Upload your own phone recording to fill it (see below), or allow Mockvid as above and generate again.
Plan B: upload your own video
Record the scroll yourself with any screen recorder, then use Upload your own video in the app. The 3D scene, motion and export work exactly the same. With a One Site unlock, your recording of that site exports without the watermark after a blocked capture; other uploads need Studio.
Which file to upload. Any video or image your browser can play; the file stays on your machine and is never re-encoded. MP4 (H.264) is the safest choice, and it also exports noticeably faster than WebM. What matters is the aspect ratio, not the resolution: the video is mapped onto the device screen as-is, so a different ratio will look stretched.
- Desktop screen: 16:9, for example 1920×1080.
- Phone screen: 390:844 (roughly 9:19.5), for example 1170×2532, the native size of a recent iPhone.
An intro animation or loader is cut off
The Wait before recording slider controls the pause between page load and the start of filming. Set it to 0s to catch intro/loader animations from the very beginning, or raise it to skip them and let heavy pages settle.
Capturing Figma designs
On the Studio plan you can paste a Figma file link instead of a website URL. Mockvid exports your frame and films it with the same scrolling treatment. Make sure the frames are accessible with the link and tall enough to scroll. Website-specific options (cookies, lazy-load, language) don't apply to Figma captures.
Still stuck?
Send us the URL and what you expected through the in-app feedback form or the contact page. Real capture cases like yours are how the engine improves.