Skip to content

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.

SEE PLANS AND STORAGE

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.

1

Check the privacy setting

Is the video Private, Unlisted or restricted by domain? Private videos only play for team members, even when embedded.

2

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.

3

Check the plan

Did a paid plan end or fail to renew? On Free, the newest uploads are restricted first and their embeds stop.

4

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?

No. A missing hash or an unlisted domain takes a few minutes to fix, and changing hosts will not save you that time. If this was your cause, fix it and stay.

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
uncompressed.io
Hiddenfrom the public
Unlisted needs its privacy hash in the embed URLEmbed only is listed for paid plans
Embed-only mode on every plan, free includedThe embed plays; the watch page returns 404 to everyone but you
Passwordprotected
Password is listed for paid plansSwitched to Private if the plan lapses to Free
Does not play in an embedThe player shows “This video is unavailable”
Bandwidth
2TB per month threshold on self-serve plansUnresolved outreach can lead to a suspension that stops embeds
Not meteredNo per-view or bandwidth overage charges
Archivedfilms
Restored if you upgrade within a year of lapsing to Free
Must be restored before streaming, embedding or reviewRestoring needs free hot space

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

If your embeds broke because of a privacy hash, a domain list or a plan that simply needs renewing, fixing it on Vimeo is faster than moving. A move makes sense when bandwidth outreach is the real problem, or when you want your site’s films off a traffic meter for good.

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.