WP Video Popup – Responsive YouTube & Vimeo Video Lightbox


WP Video Popup lets you add a responsive YouTube or Vimeo video lightbox popup to any page or post of your website.

Use the shortcode

[wp-video-popup video="link-to-your-youtube-or-vimeo-video"]

in your post, page or template file to embed your responsive YouTube or Vimeo lightbox popup.

To open the popup, add the CSS-class


to the element you wish to trigger the lightbox.

GDPR Compliance

WP Video Popup is 100% GDPR compliant. No connection to YouTube or Vimeo is established before the trigger element has been clicked.

Page Speed

Embedding YouTube or Vimeo videos can slow down your website. With WP Video Popup, the lightbox & video are only being loaded by the click on the trigger element.


Example Shortcode to display a YouTube video:

[wp-video-popup video="https://www.youtube.com/watch?v=YlUKcNNmywk"]

Example Shortcode to display a Vimeo video:

[wp-video-popup video="https://vimeo.com/136696258"]

CSS class that needs to be added to the element you want to open the lightbox:


Trigger Element Example (Link):

<a href="#" class="wp-video-popup">Play Video</a>

Shortcode Attributes

There are attributes available to add parameters to the embed-URL that’s dynamically generated from the video link provided in the shortcode.

Mute video:


Hide related YouTube videos:
Since September 2018, hiding related videos is no longer possible. Instead videos from your channel will be shown.


Start video at a specific time (value in seconds):


Portrait mode:
Vimeo for instance allows you to upload videos in portrait mode.


Example Shortcode with shortcode attributes:

[wp-video-popup mute="1" start="24" video="https://www.youtube.com/watch?v=YlUKcNNmywk"]


In addition to the Shortcode Attributes, there is a filter available to add more parameters to the embed-URL. By default, only the autoplay attribute is added to the embed-URL.

In the example below, we use the filter to remove the YouTube branding from the video by adding the modestbranding parameter:

function prefix_your_custom_embed_url_attributes( $video_url ) {
    $video_url .= '&amp;modestbranding=1';
    return $video_url;
add_filter( 'wp_video_popup', 'prefix_your_custom_embed_url_attributes' );

WP Video Popup PRO

For multiple popups on a single page, autoplay on page load functionality, self-hosted videos & more check out WP Video Popup PRO!


  • Multiple Popups on a single Page/Post
  • Self-Hosted Videos (New!)
  • Autoplay on Page-Load
  • Adjustable Popup Size
  • Overlay Background-Color Setting

Get WP Video Popup PRO today!


  • Desktop Example
  • Mobile Example


  1. Download the responsive-youtube-vimeo-popup.zip file to your computer.
  2. Unzip the file.
  3. Upload the responsive-youtube-vimeo-popup folder to your /wp-content/plugins/ directory.
  4. Activate the plugin through the Plugins menu in WordPress.

Preguntas frecuentes

How do i use this plugin?

WP Video Popup doesn’t create an admin settings page. To trigger and display the lightbox popup, please follow the steps under Description.

The video doesn’t play automatically

We add the autoplay attribute to the embed-URL by default. That being said, the video should play automatically after the trigger element has been clicked. Some browsers have changed their autoplay policy and videos only start playing if they’re muted.

To mute the video, add the mute="1" attribute to the shortcode like this:

[wp-video-popup mute="1" video="https://www.youtube.com/watch?v=YlUKcNNmywk"]


13 de abril de 2019
Was looking at a couple of plugins before but this one matched my needs perfectly. A simple way to launch YouTube videos from an image link to a clean popup. Thanks for developing!
30 de marzo de 2019
This plugin is a great alternative to the default WordPress embed function. It is well-coded, does exactly what it says it does, and is easy to set up. I've used it to speed up page load times by only loading the video if the play button is pressed, saving around 1mb in render-blocking JavaScript on load.
21 de febrero de 2019
Kept putting my video links in the shortcode, but the only thing it would play was a Red Hot Chilli Peppers video. And even that didn't show up as a link or image, you had to hover the cursor over the screen until it changed to a pointer! Very odd.
26 de septiembre de 2018
This plugin does exactly what it says. It gives you a clean video popup that is responsive! Amazing work!
Leer todas las 18 reseñas

Colaboradores y desarrolladores

«WP Video Popup – Responsive YouTube & Vimeo Video Lightbox» es un software de código abierto. Las siguientes personas han colaborado con este plugin.


Registro de cambios

2.7 October 15, 2019

  • New: Added support for portrait videos (Vimeo). To declare a vertical video, simply add the portrait="1" parameter to your shortcode.

2.6 September 26, 2019

  • Code Improvements

2.5.1 September 16, 2019

  • Fixed: Safari full-screen mode doesn’t work

2.5 August 27, 2019

  • New: youtube-nocookie.com support
  • Deprecated: vimeo=»1″ parameter to declare a Vimeo video. No longer required. We now check that for you in the background.
  • Tweak: Improved backwards compatibility
  • Overall code improvements

2.4 April 8, 2019

  • Tweak: Added allow=»autoplay» parameter to iframe to allow autoplay in Chrome (Thanks @owenmack)
  • Fixed: A bug where URL Parameters weren’t added properly using Shortcode Attributes
  • Fixed: Vimeo video was not muted with mute=»1″
  • Deprecated: hide-related Shortcode Attribute

2.3 December 12, 2018

  • New: Shortcode Attributes to add URL Parameters (mute, hide-related, start)
  • Tweak: Updated PAnD to the latest version
  • Tested up to WordPress 5.0

2.2 September 23, 2018

  • New: filter to add attributes to the embed-URL

2.1 September 4, 2018

  • New: minor tweaks & improvements

2.0 August 25, 2018

  • New: shortcode has changed to [wp-video-popup video=»link-to-your-video»] for YouTube videos and [wp-video-popup vimeo=»1″ video=»link-to-your-video»] for vimeo videos
  • New: instead of the embed-URL, the direct YouTube/Vimeo video link can now be used in the shortcode
  • Fixed: nesting the shortcode causes other elements overlapping the lightbox.
  • 100% backwards compatibility
  • minor CSS tweaks and improvements

1.1.2 05/16/2017

  • removed admin notice
  • updated plugin description

1.1.1 05/20/2017

  • Added: Elementor support – by adding !important to the video iframe width and max-width attributes to prevent Elementor (and others) from overwriting.

1.1 02-27-2017

  • stability & maintenance release
  • Added: use ESC-key on your keyboard to close the popup


  • Tweak: Increased z-index to make sure ryv-popup is on top


  • Initial Release