Plugin Directory

Velocity – Video Lazy Loading for YouTube, Twitch and Vimeo

This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Velocity – Video Lazy Loading for YouTube, Twitch and Vimeo


Velocity is an alternative loading method to the standard to YouTube, Vimeo, Twitch and Soundcloud iframe embeds.

With Velocity you will decrease the loading time and increase overall performance of your website by lazy loading media on-demand instead of on initial page load.

To add Velocity to your site, simply create a Velocity shortcode by selecting a preview image and media type using the intuitive shortcode builder then add the generated snippet to your page.

Get More Information

Shortcode Parameters

  • type – Choose a media type [youtube, vimeo, twitch, soundcloud].
  • id – The ID of the media item.
  • options – Add optional styling and display parameters for the embedded media – e.g. rel=0&controls=0&showinfo=0.
  • playlist – Is this a Soundcloud playlist [true/false].
  • img – The path to the preview image.
  • alt – The alternative text to be attached to the preview image.
  • color – Play button arrow color.
  • bkg_color – Play button background color.

Example Shortcode

[velocity type="youtube" id="239793212" img="http://yourwebsite.com/wp-content/uploads/2016/01/image-1263626715.jpg" alt="Play Video"]

Tested Browsers

  • Firefox (Mac, PC)
  • Chrome (Mac, PC, iOS, Android)
  • Safari (Mac, iOS)
  • IE10+
  • Android (Native)
  • BB10 (Native)




  • Settings.
  • Velocity shortcode builder.
  • Add Velocity (page/post edit screen).
  • Velocity lightbox (page/post edit screen).


How to install Velocity.

Using The WordPress Dashboard

  1. Navigate to the ‘Add New’ in the plugins dashboard
  2. Search for ‘Velocity’
  3. Click ‘Install Now’
  4. Activate the plugin on the Plugin dashboard

Uploading in WordPress Dashboard

  1. Navigate to the ‘Add New’ in the plugins dashboard
  2. Navigate to the ‘Upload’ area
  3. Select velocity.zip from your computer
  4. Click ‘Install Now’
  5. Activate the plugin in the Plugin dashboard

Using FTP

  1. Download velocity.zip
  2. Extract the velocity directory to your computer
  3. Upload the velocity directory to the /wp-content/plugins/ directory
  4. Activate the plugin in the Plugin dashboard


What are the steps to getting Velocity integrated on my website
  1. Create your Velocity shortcode.
  2. Add the shortcode to your page, by adding it through the content editor or placing it directly within one of your template files.
  3. Load a page with Velocity in place, click the preview image and load your media.


October 23, 2017 1 reply
This plugin is hands down the best WordPress lazy load plugin there is. Locally hosted custom image support makes this lightning fast. Highly recommended.
June 14, 2017 1 reply
It is one if the plugins that “just works”. Awesome. Thanks!
March 15, 2017 1 reply
The plugin works great and does everything that promises. But what I appreciate the most is that Darren, who develops the plugin, is always listening, helping and implementing new suggestions. When you choose a plugin for your website, is important to make sure it’s regularly updated and won’t be abandoned. Darren puts a lot of effort on this aspect. In fact, all the plugins he creates are pure gold. Thanks a lot for all your work and effort. Keep up the good work, man!
September 3, 2016 1 reply
An excellent plugin, and one of the easiest to use that I’ve seen. Some people may want control over additional parameters, in which case look elsewhere, but if you just want to put lazy loading videos on a page as simply and quickly as possible, I’d highly recommend this. It also does away with YouTube’s related videos, which is another huge plus point in my book.
Read all 6 reviews

Contributors & Developers

“Velocity – Video Lazy Loading for YouTube, Twitch and Vimeo” is open source software. The following people have contributed to this plugin.



1.2.1 – January 4, 2020

  • UPDATE – Update admin CSS styling for issues with new WordPress 5.3 accessibility styles.
  • UPDATE – Improved meta data classes.

1.2.0 – July 23, 2019

  • NEW – Added Twitch support.
  • NEW – Added responsive styling for play button.
  • NEW – Added focus state for accessibility.
  • NEW – Add SEO Metadata to YouTube, Vimeo and Twitch embeds. YouTube and Twitch metadata is still a work in progress and will be evolving.
  • FIX – Removed issue with .clearfix class causing issue with page builders

1.1.1 – March 17, 2017

  • FIX – Patch for PHP warning regarding $soundcloud_type variable.

1.1 – March 14, 2017

  • Added fade out transition from preview image to media embed.
  • Added new options shortcode parameter to pass various options to embed video – e.g. autoplay=1&loop=1&title=0
  • Added support for Soundcloud playlists – e.g. [velocity type=”soundcloud” playlist=”true” id=”1659224″ alt=”Play” color=”#FFFFFF” bkg_color=”#000000″]).
  • UI Updates and enhancements.

1.0.1 – May 10, 2016

  • Adding .min js file
  • Adding support for loading Velocity media with Ajax

1.0 – March 3, 2016

  • Initial Plugin Release