Skip to main content

Embed background and chromeless videos

This feature requires a paid plan on Vimeo.

This feature enables you to hide all elements in the player (e.g play/pause, playbar, share, etc) for your embedded videos.

Background videos

To embed a video as the background element of your website, add the following parameter to the end of the player URL in your embed code:

?background=1

Adding this parameter will have the following effect: 

  1. All player toggles and elements will be turned off (including the play/pause button!)
  2. The video will automatically loop.
  3. The video will be set to autoplay.
  4. The video will be muted.

Note that setting this parameter will not disable keyboard controls. 

Example Embed Code:

<iframe src="https://player.vimeo.com/video/76979871?background=1" width="640" height="360" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>

If you would like your background video to play with sound*, you can also add the muted=0 parameter to your embed code. For example: 

<iframe src="https://player.vimeo.com/video/76979871?background=1&muted=0" width="640" height="360" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>

*Please note that Chrome, Safari, and Firefox all have autoplay restrictions in place that will prevent videos from automatically playing with sound. Muted background videos will not be affected. For more on this, please see the Autoplay Restrictions section of the 'Autoplay and loop embedded videos' Vimeo Help Center article. 

Chromeless players 

If you would simply like to hide the UI in the player without muting/autoplaying/looping, you can alternatively add the following parameter to the end of the player URL in your embed code:

?controls=0

When using this parameter, the playbar will be hidden. In order to control playback, you'll need to either enable autoplay (?autoplay=1), use keyboard shortcuts, or implement our player SDK to start and control playback.

Example Embed Code:

<iframe src="https://player.vimeo.com/video/76979871?controls=0" width="640" height="360" frameborder="0" allow="autoplay; fullscreen" allowfullscreen></iframe>

Please note that if you are adjusting the embed code of a video set to the Unlisted privacy setting, additional parameters must be added after the privacy hash parameter. This will appear directly after the video ID in the URL and looks similar to ?h=913062c8ff. Every parameter after the hash​ can be added using & rather than ?

Related articles