Load video on click

plugin banner

Videos will not worse anymore the performance if you embed them using the shortcode provided…

Author:Jose Mortellaro (profile at wordpress.org)
WordPress version required:4.6
WordPress version tested:6.0
Plugin version:0.0.5
Added to WordPress repository:06-01-2022
Last updated:22-05-2022
Rating, %:0
Rated by:0
Plugin URI:
Total downloads:399
Active installs:30+
plugin download
Click to start download

Videos will not worse anymore the performance if they load only after clicking on the play button.

How to load videos on click

  • Install and activate Load Video On Click
  • Embed the videos using the shortcode [load_video_on_click] (see below) or by activating the switch “Load on click” of the Video and Embed blocks (in case of Gutenberg)


You can always add the provided shortcode, no matter which builder you are using. However, the actual version provides a full integration with the following builders (no need for the shortcode):

  • WPBakery
  • Gutenberg


Shortcode name: load_video_on_click

Shortcode parameters:

  • link: Video URL
  • el_id: ID for custom CSS
  • el_aspect: video aspect ratio
  • el_class: class for custom CSS
  • image_placeholder: Image to be loaded instead of the video. You can use the ID or the URL of the image.
  • load_on_click: Set on to load the video only after clicking on the button, or off to load it on page loading

Shortcode example:

[load_video_on_click link=”https://www.youtube.com/watch?v=AQ3FoNHC6SU” image_placeholder=”356″]

IF you embed a Youtube video and don’t set the image placeholder parameter, the plugin will get it directly from Youtube.
For the other video providers or if you self host the video file, you need to set the parameter image_placeholder, in another case people will only see a play button before loading the video.


If you use Gutenberg, the blocks Embed and Video will have the switch “Load on click”. Activate that switch to load the embedded video after clicking on the play button.
Don’t forget to set a Poster Image. It will be taken as placeholder before starting the video.

Case study

Click here to see the GTMetrix report of a blog post that includes a video.
As you can see even thought that blog post has a video, the score is 100/100. You can forget this kind of score just lazy loading the video, you need to load it after the click of the user.


For any question or if something doesn’t work, don’t hesitate to open a thread on the support forum.

For developers

Filter hooks


It enables/disables the loading on click for existing videos added with the Video and Embed blocks (Gutenberg).


add_filter( 'load_video_on_click_for_blocks','__return_true' ); //It enables the loading on click for all videos added with the Video and Embed blocks


You can use it to replace the image placeholder.


add_filter( 'load_video_on_click_image_placeholder',function( $url,$attrs ){
  //$attrs is the array of parameters in case of shortcode, and the block attributes in case of Gutenberg blocks
  if( false !== strpos( $url,'yout' ) ){
    //Same image placeholder for all Youtube videos
    return wp_get_attachment_url( 2009 );
  return $url;
},2,20 );