Plugin Directory

YouTube Embed

A simple to use method of embedding YouTube videos into your posts and pages but with powerful features for those that need them.

I've upgraded to version 4.0+ from an earlier version and I was using the widget feature to display videos

I previously allowed some, although not all, parameters to be specified within the widget. However, as you can simply create your own profile for widgets I have removed this and, without leaving lots of redundant code behind, it was difficult to keep this backwards compatible.

Therefore, if you're upgrading you may find your widgets don't now display correctly. The best thing to do, beforehand if you can, is to create a profile just for the widgets and assign that to each. You'll probably find the video size is the bit most likely to cause issues. Apologies for this.

How do I find the ID of a YouTube video?

If you play a YouTube video, look at the URL - it will probably look something like this - http://www.youtube.com/watch?v=L5Y4qzc_JTg.

The video ID is the list of letters and numbers after v=, in this case L5Y4qzc_JTg.

The video output is overlapping or stuttering

If you go into the Profile screen in Administration there is a "Window Mode" option. This defines how Flash output interacts with any other around it. "Window" is the default and gives good performance but may cause overlapping. If overlapping is causing an issue try "Opaque".

No video is showing

If you find no video is showing but there's no error either check the source code of the page. Can you find the text "" in the page? If so, you have Jetpack installed and that is displaying the video instead.

There are two ways around this.

First, you could disable all the shortcodes in Jetpack - Jetpack allows you to deactivate certain "modules" of the plugin and, if you can live without the other extra shortcodes, deactivating the shortcodes part will restore functionality back to YouTube Embed

Alternatively, you can use a secondary shortcode - [youtube_video]. Use this instead of [youtube ] and YouTube Embed will render the results without a problem

This second suggestion will work for any plugin that may use the same shortcode.

My OPTIONS table seems to be full of cache entries for YouTube Embed

Due to a housekeeping limitation in WordPress cache entries, which are stored in the OPTIONS table, may get left behind. There are 2 solutions to clearing this.

First of all, in the Options menu in YouTube Embed administration, there is an option in the performance section named "Clear Cache". Simply tick this box and click on the "Save Settings" button to clear out any cache.

However, the best option is to install the plugin Transient Cleaner, which will housekeep the OPTIONS table automatically.

Is this plugin compatible with Turn Off The Lights?

Yes, it works beautifully with Turn Off The Lights, thanks to the very kind Develop

The "autostart" feature is not working in iOS

Unfortunately, this is a restriction that has been put in place by Apple.

I can't get the video to play at a specific resolution by default

There is no way to specify this - YouTube makes the decision on which version to play depending on a number of factors.

There are black borders on top/underneath my video

This is usually due to using a different ratio than the video was designed for. If you're not sure which ratio to use head to its page on YouTube, click on Share and then Embed and then Show More. A video size will be shown, which you can use to work out the correct ration for the video.

The controls under the video don't display properly when using Firefox

This is a bug in Firefox. Short term, switch on SSL in the Profiles screen and it will work. Longer term, I've raised a bug report with Mozilla.

I have another issue or a request

Before reporting it please bear in mind that this plugin uses the standard YouTube API. Adding extra functionality to the player itself is not possible and there are known issues with it. I would also recommend performing a Google search for your issue too first, as this will often resolve a lot of queries.

Requires: 3.9 or higher
Compatible up to: 4.3.1
Last Updated: 2 weeks ago
Active Installs: 30,000+


3.9 out of 5 stars


11 of 14 support threads in the last two months have been resolved.

Got something to say? Need help?


Not enough data

1 person says it works.
0 people say it's broken.

75,4,3 100,2,2
100,1,1 100,1,1 100,1,1 100,3,3 55,11,6 100,2,2 100,4,4
100,3,3 100,3,3 100,5,5
100,1,1 100,2,2 100,1,1 100,1,1 100,2,2 60,5,3
0,2,0 100,1,1
0,1,0 100,1,1 100,4,4 100,1,1
50,2,1 100,1,1 100,3,3 100,3,3 100,1,1 100,1,1
100,2,2 100,1,1 100,2,2 100,1,1
100,2,2 100,1,1
100,1,1 100,2,2
100,1,1 100,1,1 100,1,1