Leaving Vimeo · Troubleshooting
Your Vimeo embed stopped working.
Three documented causes, quickest to check first.
Vimeo's own help centre explains why an embedded player stops playing. It can be a privacy setting you can fix in minutes, a plan that ended, or a bandwidth suspension. Here is how to tell which one you have, and what to do about each.
Video hosting for filmmakers · 5 GB free · Paid plans from USD 9/month
By uncompressed.io · Updated September 2026
Two-minute triage
Find the cause
before you change anything.
Open the video’s page while signed in to Vimeo. If it plays there but not on your site, the likeliest cause is a privacy setting. If it does not play there either, look at your plan and then at your account notifications.
Check the privacy setting
Is the video Private, Unlisted or restricted by domain? Private videos only play for team members, even when embedded.
Compare the embed code
For an Unlisted video, the embed URL must still carry its privacy hash (?h=...). Copy a fresh embed code and compare.
Check the plan
Did a paid plan end or fail to renew? On Free, the newest uploads are restricted first and their embeds stop.
Check your notifications
Bandwidth outreach arrives as automated notices first. An unanswered one can end in a temporary suspension.
Cause 1, the quickest to fix
A missing privacy hash,
or a domain that is not allowed.
When you switch a video to Unlisted, Vimeo adds a privacy hash to its URL, and its help centre says the hash must be included for embeds and sharing to work. An embed code copied before the switch, or rebuilt by hand, often leaves it out. Vimeo’s parameter guide also says that for Unlisted URLs such as ?h=913062c8ff, every other parameter must come after the hash, joined with &, so check the order as well as the hash itself.
Fix: copy a new embed code from the video’s share options and replace the old one on your site. If you add options by hand, put them after ?h=....
The second version of this cause is domain-level privacy. If you limited where the video may be embedded, Vimeo’s embed FAQ says you must allow your website’s domain. If your site recently moved to a new domain, check that the new one is on the list.
Fix: add the exact domain your page is served from to the video’s embed settings. If the video is Private, Vimeo’s advice is to use Unlisted instead, because Private videos only play for team members.
If the player says the video does not exist, Vimeo has a separate troubleshooting article for that message.
Should you move for this one?
Cause 2
A plan that ended,
and the newest uploads go first.
When a paid plan lapses to Vimeo Free, Vimeo’s help centre describes a chain of changes that reach your website directly:
- Videos beyond the Free plan’s 1 GB are restricted, and the most recent uploads are the first to be restricted. That is why your newest embed often breaks first while older ones keep playing.
- Restricted videos cannot be played, edited or downloaded, and their clip pages and embeds stop working.
- Password, Unlisted and Embed only videos are switched to Private, which only team members can see.
- Domain-level embed privacy is changed to Nowhere. You must set it to Anywhere to embed again.
- Player customizations go back to the default.
A lapse to the legacy Basic plan follows the same newest-first rule with a 5GB cap, and restricted embeds stop working there too.
Fix: renew the plan, or bring the library under the cap. Vimeo says archived videos are restored if you upgrade within a year of lapsing. After renewing, check each video’s privacy setting and set domain-level privacy back from Nowhere, because those changes are not described as being undone for you. Restricted videos cannot be downloaded, so if you plan to leave, renew first and take your files out while the plan is active. The cancellation guide covers the order to do this in.
Cause 3
A bandwidth suspension,
after a seven-day window.
Vimeo’s bandwidth policy for self-serve plans sets a threshold of 2TB per month. It says that going over it does not normally stop streaming. Outreach starts when an account has gone over 2TB in a month at least twice in the past 12 months, or over 10TB once. Automated notices come first, then Vimeo’s team may get in touch.
From there you have seven days to reach a resolution, with no account changes during that time. If nothing is resolved, the account is at risk of a temporary suspension. Suspended videos stop playing wherever they are distributed or embedded. You still have access to the videos, but your website does not.
The newer Creator plan lists 1TB of monthly bandwidth, and Vimeo says that plan is being rolled out gradually. The bandwidth article does not say how the 1TB figure is enforced, so check the plan and notices on your own account.
Fix: answer the outreach inside the seven days and agree a resolution with Vimeo. Our bandwidth guide explains how to estimate your traffic before that conversation.
Where a different host helps
One cause goes away,
the other two do not.
On uncompressed.io, streaming is not metered: the plans meter storage, archive space, seats and caption minutes, not views or bandwidth. Unlimited video streaming is included, with no per-view or bandwidth overage charges. Storage and team-seat charges are separate. So a traffic spike on your site cannot lead to a bandwidth suspension of your embeds.
The other two causes have equivalents here, and it is fairer to say so. Privacy still decides what an embed will play, and a plan still caps storage. The table sets out what changes and what does not.

Vimeo rows from Vimeo's help centre, fetched 2026-09-16. uncompressed.io rows from the product, verified 2026-09-16.
Two points to check before you move. First, storage: 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. Second, playback quality depends on the viewer. Browser playback uses your uploaded export without another platform re-encode. Codec, device and connection requirements still apply. If your site’s visitors are on slow connections, export a file sized for them.
The embed takes eight optional parameters: autoplay (which always starts muted), muted, loop, title, playbtn, accent colour, controls (hover or none) and background (transparent or a six-digit hex colour). Settings saved in your dashboard apply first, and URL parameters override them. The embed-only guide shows how to keep a film off the public web while it plays on your site.
Who should stay on Vimeo
Questions
Frequently asked
The Vimeo player on my site shows an error. Where do I look first?
Vimeo's embed FAQ says to check your privacy settings first. A video set to Private can only be seen by team members, even when it is embedded, and Vimeo's advice is to use Unlisted instead. If the video is Unlisted, make sure the privacy hash is still in the embed code. If you use domain-level privacy, make sure your website's domain is on the allowed list.
If I upgrade again, do my restricted Vimeo videos come back?
Vimeo's article on lapsing to Free says archived videos are restored if you upgrade within a year of lapsing. It does not say what happens after that year. Your privacy settings and player customizations were changed when the plan ended, so check each embed after upgrading: domain-level embed privacy may still be set to Nowhere.
Why does my Vimeo embed not autoplay any more?
That is usually the browser, not Vimeo. Browsers restrict autoplay with sound. Vimeo's documented fix is to add allow=autoplay to the iframe or to play the video muted. On uncompressed.io, the autoplay=1 embed parameter always starts the film muted for the same reason.
Does uncompressed.io have a bandwidth cap that could stop my embeds?
Unlimited video streaming is included, with no per-view or bandwidth overage charges. Storage and team-seat charges are separate. Storage is capped per plan, so check the plan's storage on the pricing page before you move a library.
Can I embed a password-protected film on uncompressed.io?
No. A password-protected, private or vault film shows 'This video is unavailable' inside an embed. To keep a film off the public web and still play it on your site, use the embed-only mode: the embed plays, and the watch page returns a 404 to everyone but you.
Embeds that are not tied to a traffic meter
Streaming is not metered on any plan; storage and seats are what you pay for. Paid plans start at $9 a month, and the free plan holds 5 GB, one film at a time, so you can test one embed on your own site first.
Sources
- 1.Vimeo Help, About video privacy settings (updated 2026-07-07) (fetched 2026-09-16)
- 2.Vimeo Help, embed URL parameters and the privacy hash (updated 2026-01-14) (fetched 2026-09-16)
- 3.Vimeo Help, FAQ: Embedded videos (updated 2025-12-09) (fetched 2026-09-16)
- 4.Vimeo Help, Embedded player displays 'This video does not exist' message (updated 2025-11-03) (fetched 2026-09-16)
- 5.Vimeo Help, what happens when a plan lapses to Vimeo Free (updated 2026-08-05) (fetched 2026-09-16)
- 6.Vimeo Help, what happens when a plan lapses to legacy Basic (updated 2026-08-05) (fetched 2026-09-16)
- 7.Vimeo Help, Bandwidth on Vimeo (updated 2026-06-29) (fetched 2026-09-16)
- 8.Vimeo Help, About the Vimeo Creator plan (updated 2026-08-13) (fetched 2026-09-16)
- 9.Vimeo Help, autoplay and browser restrictions (updated 2025-12-09) (fetched 2026-09-16)
- 10.uncompressed.io pricing and plans (product page, verified)
- 11.uncompressed.io embed-only hosting guide (product page, verified)
