Viper's Video Quicktags Migrator


This plugin is written by the same author as Viper’s Video Quicktags. You only need this plugin if you were a previous user of it.

Viper’s Video Quicktags was a popular but no longer maintained plugin that I wrote that made it easy to embed videos into your WordPress site. Since the plugin was originally written over 10 years ago, WordPress has added native embed support which allows you to easily embed videos out of the box. Its functionality is far superior to that of the plugin and most people have switched to using it.

Unfortunately many people have been left with old posts that use the plugin’s shortcodes and manually migrating over to the new embed method would be a time consuming and tedious task.

Instead this plugin will take over parsing those shortcodes, making use of the native WordPress functionality instead.

Note: This plugin does not add any buttons to the editor like VVQ did as you no longer should need them. Just paste the video URL on its own line, as documented in the Codex.

Bug reports (but not support requests) and pull requests are welcomed via GitHub. Please use the WordPress forums for support.


  1. Visit your WordPress admin area and navigate to Plugins → Add New.
  2. Search for this plugin and install and activate it.
  3. Deactivate Viper’s Video Quicktags and then delete it. You won’t need it.


Where did the buttons in the editor go?

You don’t need them anymore. Just paste the video URL on its own line in your post. See the WordPress Codex for further details.

How do I control the default embed size? This plugin doesn’t have a settings page!

Make sure your theme is telling WordPress how wide it’s content area is. See the Content Width Codex article for further details.

Why can’t this plugin do […] that Viper’s Video Quicktags plugin used to do?

This plugin’s primary goal is to make the old shortcodes work. The new embed functionality works fine out of the box, and if you want to customize those embeds, you can do so separately from this plugin.

Plus many things are just no longer possible, for example customizing the colors of the YouTube player.

Why can’t I make YouTube videos autoplay anymore?

Previously Viper’s Video Quicktags would construct the embed HTML entirely by itself. This allowed more flexibility but unfortunately this also meant it got out of date with the recommended embed HTML. For example YouTube switched to HTML5 instead of Flash and my plugin never made that switch. It also meant that embeds would often have black borders around them since the embed size wouldn’t match the video proportions.

Instead WordPress directly asks YouTube itself for the embed HTML for every embed it does. This means that the embed is pixel perfect and always up to date. Unfortunately YouTube doesn’t support autoplay using this method as far as I can tell.

Autoplay is lame anyway! 🙂


Not everybody thinks about 'bit rot' — thanks Viper for remembering us!

Viper's Video Quicktags was always the first plugin I would install on a fresh WP installation, a decade ago. Of course, a lot of those links are still on my 12-year-old blog, and I was always weary about removing Viper's Video Quicktags because I didn't want all the old pages to fail... One of the toughest thing to maintain on the Internet are long-lived websites and services. Everything is subject to 'bit rot' — things that stop working suddenly because they aren't supported any more. Most plugin/theme writers couldn't care less about supporting decade-old software. Viper, however, did a great job with this 'replacement', which will make sure that those ancient links will still work, but now with WP's built-in handling, which, in almost cases, is much superior to what a venerable, 10-year-old plugin can do. So we get the best of both worlds: modern file embedding and support for old links 🙂
Read all 3 reviews

Contributors & Developers

“Viper's Video Quicktags Migrator” is open source software. The following people have contributed to this plugin.




  • Remove characters that I fat-fingered in. Oops!


  • Fix PHP warning.


  • Don’t take over WordPress’s [video] shortcode.
  • Alias the [flv] and [wmv] shortcodes to WordPress’s [video] shortcode since it can handle those file types out of the box.


  • Jetpack plugin compatibility. Should fix broken embeds if you have the “Shortcode Embeds” module enabled.


  • Initial release.