Skip to content

Event Types

Yuhui edited this page May 9, 2024 · 5 revisions
Event Type Description Available configuration options
API Changed The YouTube player has loaded (or unloaded) a module with exposed API methods.  
Autoplay Blocked The user's browser blocks autoplay or scripted video playback features, collectively referred to as "autoplay"..  
Player Error An error has occurred in the YouTube player.  
Player Ready The YouTube player is loaded and ready to receive events from the YouTube IFrame API.  
Player Removed The YouTube player is unloaded from the browser window, e.g. when the browser navigates to another page, when the browser tab/window is closed, etc.  
Playback Quality Changed The video playback quality has changed.  
Playback Rate Changed The video playback rate has changed.  
Video Buffering The YouTube player is buffering a video.  
Video Cued The YouTube player has cued a video for playing.  
Video Ended The YouTube player has finished playing a video.  
Video Milestone The YouTube player has reached a particular moment ("milestone") in the playing video.
 
For "live" videos, milestones are based on when the video has started playing.
Set fixed thresholds by percentages or seconds, e.g. "25, 50, 75 per cent".
 
Only seconds-based thresholds can be used with "live" videos.
Video Paused The YouTube player has paused a video.  
Video Playing The YouTube player is playing a video. Set it differently based on the playback state:
  • When the video has started playing after it had been first loaded.
  • When the video has resumed playing after it had been paused.
  • When the video has restarted playing after it had ended.
Video Unstarted The YouTube player has loaded a video but is not playing it.