Skip to main content
Version: 4.x


Enables loading, playing and controlling videos from YouTube.

You don't interact with this component for passing player properties, controlling playback, listening to player events and so on, that is all done through the vime-player component.


  • When the player is paused, seeking and seeked are fired at the same time (in order), because there are no updates between the events from the embed.

  • Changing the controls prop forces the player to reload.

  • You cannot change playbackQuality programmatically, YouTube automatically determines the best quality to play.

  • Fullscreen changes that come from clicking the YouTube fullscreen control are not tracked on iOS, because the embed doesn't provide an API for it.


<vime-player controls>
<vime-youtube video-id="DyTCOwB0DVw"></vime-youtube>
<!-- ... -->


cookiescookiesWhether cookies should be enabled on the embed.booleanfalse
posterposterThe absolute URL of a custom poster to be used for the current video.string โˆฃ undefinedundefined
showFullscreenControlshow-fullscreen-controlWhether the fullscreen control should be shown.booleantrue
videoId (required)video-idThe YouTube resource ID of the video to load.stringundefined


Used by#

Depends on#


graph TD;
vime-youtube --> vime-embed
vime-playground --> vime-youtube
style vime-youtube fill:#f9f,stroke:#333,stroke-width:4px

Built with StencilJS