Framer, portfolio video
Embed video in Framer.
An unbranded player, captions, and a link that survives a recut.
Framer's own Video component is a fine choice for many sites. This guide shows when an external player earns its place, and how to put one into Framer's Embed component in a few minutes.
Video hosting for filmmakers · 5 GB free · Paid plans from USD 9/month
By uncompressed.io · Updated September 2026
Start with what Framer already does
Framer does not compress your file,
so the reason to switch is not quality.
Framer’s help centre is direct about it: Framer “does not optimize or compress the video content itself”. What it does optimize is how video loads, and it asks you to “upload web-optimized video files”.
Under Insert, in the Media section, Framer offers three video components: Video, YouTube and Vimeo. The Video component takes a local upload or a hosted MP4 file. The YouTube and Vimeo components take the video’s link in their settings. The settings Framer’s article mentions are autoplay, a poster image, border radius and accessibility.
One detail is worth knowing before you drag a file onto the canvas. In its lazy-loading article, Framer describes uploading videos directly as “not recommended”. That points you toward a hosted file or a hosted player either way.
So here is the honest version. If Framer’s Video component, or its YouTube or Vimeo component, already plays your film the way you want, you may not need anything else. An external player earns its place for three reasons: a player with no platform logo, captions you control, and an address that stays the same when you recut.
8
embed URL parameters
saved dashboard settings apply first, the URL overrides them
0
platform logos in the player
only your own logo, if you turn it on
1
address per film
replacing the file keeps it
Side by side
Framer’s Video component and an embedded player,
and what each one is for.
Framer column from Framer's help centre, updated Aug 7, 2026, fetched 2026-09-16. Framer's articles name no plan requirement for Embed or Video, and give no file size or format list, so this page states none.
The workflow
Embed video in Framer
in four steps.
Upload and set visibility
Upload a browser-compatible export. Set the film to public, unlisted or embed-only. Embed-only plays in the embed and returns a 404 on the watch page for everyone but you. Password-protected films do not play in embeds.
Copy the embed
Open the film's embed controls in your dashboard and copy the iframe, or copy only its /embed/ address. Add any of the eight parameters to the address.
Add Framer's Embed component
In Framer, open the Insert menu and search for Embed. Drag the component onto the canvas. Either input the /embed/ address into the component, or paste the iframe into its HTML tab.
Size, publish, test
Give the component the aspect ratio of your film. Publish, then open the live page signed out, on a desktop and on a phone, and play it through with sound.
The shortest route is the URL. Input an address like this into the Embed component:
https://uncompressed.io/embed/YOUR_VIDEO_ID?title=0&controls=hoverIf you prefer the HTML tab, paste a full iframe. This is a template: replace YOUR_VIDEO_ID with your film’s ID, or paste the code copied from your dashboard. The iframe fills the Embed component, so set the component’s size and aspect ratio in Framer.
<iframe src="https://uncompressed.io/embed/YOUR_VIDEO_ID?title=0&controls=hover&bg=transparent"
title="Showreel" width="1280" height="720" loading="lazy"
allow="autoplay; fullscreen; picture-in-picture; clipboard-write"
allowfullscreen
style="border:0;width:100%;height:100%;"></iframe>Framer notes that some websites block embedding through HTTP headers. The /embed/ address is the one built to be framed; use it rather than the film’s watch page.
The player, by URL
The eight embed parameters,
exactly as the player reads them.
Settings you save in the dashboard apply first. Anything you put in the embed address overrides them for that embed only, so one film can appear as a looping hero on one page and with full controls on another.
A silent looping background, the usual Framer hero, looks like this:
https://uncompressed.io/embed/YOUR_VIDEO_ID?autoplay=1&loop=1&controls=noneAutoplay here always starts muted, and browsers often block autoplay with sound anyway. For a reel a visitor should hear, leave autoplay off and let them press play.
The two reasons that last
Captions in the embed,
and the same link after a recut.
Captions you control
Generate captions from the film's audio, then edit and style them in the dashboard. They appear in the embed once ready, and export as .srt or .vtt. Caption generation is metered per month by plan; the free plan includes 20 minutes.
A link that survives a recut
Replacing a film's file keeps its ID, its address, its settings, and its timecoded notes and approvals. The old playable file is deleted once the new one is committed. The Framer embed does not need to change.
No platform branding
The player carries no platform logo. The only logo it shows is yours, when you turn it on in the dashboard.
Where it was watched
Embed views record city and device, plus how far viewers got, so you can see whether the reel on your Framer site is watched to the end. Viewers are not identified by name.
The recut workflow, including the poster and captions checklist after a swap, is in how to update a showreel without changing the link. If you place players on many client sites, the agency version is in white label video player embeds.
If the embed does not play
Four causes,
and what to check first.
It says 'This video is unavailable'
The film is password-protected, private, in the vault, or still uploading. Switch it to public, unlisted or embed-only for a website.
It worked, then stopped after archiving
Hot capacity is released after the archive copy is verified and the library change is saved. Archived films must be restored before streaming, embedding or review.
It plays on one device and not another
Browser playback uses your uploaded export without another platform re-encode. Codec, device and connection requirements still apply. Export a widely supported format for the web, such as H.264 in MP4, and test again.
The frame is blank in Framer
Check that you used the /embed/ address, not the watch page, and that the Embed component has a width and height. Then test the published page, not only the canvas.
When to stay with Framer's Video component
Questions
Frequently asked
Do I need an external player to embed video in Framer?
No. Framer's Video component accepts local uploads or hosted MP4 files, and its YouTube and Vimeo components take a pasted link. If one of those already gives you the player you want, keep it. An external player makes sense when you want no platform branding, captions you edit yourself, or one address that keeps working after you recut the film.
Will embedding through uncompressed.io make my video look better than a Framer upload?
Not by itself. Framer says it does not compress the video content itself, so an upload is not degraded by Framer. What you gain here is the player and the workflow around it. Browser playback uses your uploaded export without another platform re-encode. Codec, device and connection requirements still apply.
Should I use the URL or the HTML tab of Framer's Embed component?
Either works. The URL is quicker and takes the eight player parameters directly. The HTML tab lets you paste a full iframe, which is useful when you want to set attributes such as the title or lazy loading yourself.
Can I embed a password-protected film in Framer?
No. A password-protected film shows 'This video is unavailable' in an embed. For a film that should play only on your Framer site, set its visibility to embed-only: the embed plays, and the watch page returns a 404 to anyone but you.
Can I archive the film and keep the Framer embed working?
Hot capacity is released after the archive copy is verified and the library change is saved. Archived films must be restored before streaming, embedding or review. Keep any film your site shows in hot storage.
Put your reel in Framer without a platform logo
Start with 5 GB and one film at a time, no credit card. A portfolio with several films fits Lite, at $9 a month for 100 GB of streaming storage.
Sources
- 1.Framer Help, How to add video (updated Aug 7, 2026) (fetched 2026-09-16)
- 2.Framer Help, How to natively lazy load videos or images (updated Aug 7, 2026) (fetched 2026-09-16)
- 3.Framer Help, How to add an iframe or embed script (updated Aug 7, 2026) (fetched 2026-09-16)
- 4.Framer Help, How to embed a Trustpilot widget into your website (updated Aug 7, 2026) (fetched 2026-09-16)
- 5.uncompressed.io pricing and plans (product page, verified)