Looking for the old docs? Go here



This provider enables playing videos hosted on Vimeo via embeds.

This provider is used to embed video content hosted on Vimeo via the IFrame API. Out of the box you can enjoy the following benefits over the native embed:

  • Preconnections for faster rendering.
  • Automatically loading titles and posters.
  • Complete control of loading using load strategies. Lazy by default (only loaded when in view).
  • Autoplay failure detection.
  • No cookies by default for GDPR-compliance.
  • Vimeo Pro detection for configuring playback speed and quality.
  • Access to all of Vidstack Player features.

Refer to the Player component if you’re looking for props, methods, and events.

The following source URLs are supported and used to determine when to load the Vimeo provider:

  • vimeo/640499893
  • https://vimeo.com/640499893
  • https://player.vimeo.com/video/640499893

What is “640499893”? It’s the ID of the video which can be found in the URL when watching a video on Vimeo.

You can append a hash to any valid source for private embeds like so:


You can configure specific embed options on the provider like so: