I'm having a problem here:

I am passing this through a custom field: http://www.youtube.com/watch?v=E6P1Q-UycHA&autoplay=1

(notice the autoplay=1)

But when I load the video on my theme using wp_oembed_get... it displays the video fine, but it does not listen to the autoplay=1 variable I am passing through.

I need the videos to play on the load of the page.

Any ideas?

Thanks, Alain Fontaine


7 Answers 7


Those are not really arguments like for YouTube, more of arguments for WordPress itself.

One way to handle it would be to access your argument later inside of a filter and modify HTML output.

Pass in arguments array:

wp_oembed_get( 'http://www.youtube.com/watch?v=', array( 'autoplay' => 1 ) );

And filter:

add_filter('oembed_result','oembed_result', 10, 3);

function oembed_result($html, $url, $args) {

    // $args includes custom argument
    // modify $html as you need

    return $html;

I know this question is pretty old, but I have a working solution that I figure might be helpful to anyone else trying to find this info and coming up empty in Google searches.

This solution has been tested in WordPress 3.7.1+:

 * Adds the `autoplay` query string argument to embedded YouTube videos
function wpse5362_autoplay_youtube_oembed( $provider, $url, $args ) {
    if (strpos($provider, 'youtube')!==FALSE) {
        $provider = add_query_arg('autoplay', 1, $provider);

    return $provider;
add_filter('oembed_fetch_url', 'wpse5362_autoplay_youtube_oembed', 10, 3);

Add the above in your theme's functions.php to cause all YouTube videos added via oEmbed to autoplay.

How This Works

In class-oembed.php on line 212, the fetch() method applies the filter oembed_fetch_url to allow modifications to the URL.

To avoid adding useless parameters to other oEmbed providers, we check for "youtube" in the provider URL — we could also check for "vimeo" and/or other video services — and, if that string is present, adds an autoplay argument to the query string.

  • 5
    This solution doesn't work for me. It adds &autoplay=1 to the provider URL. That is NOT the iframe src, and youtube's oembed system does not carry it over. The value is lost during _fetch_with_format which is called after oembed_fetch_url. Maybe this used to work but YouTube changed their oembed api? Nov 22, 2016 at 1:19

This is my solution in functions.php

function embed_responsive_autoplay($code){
    if(strpos($code, 'youtu.be') !== false || strpos($code, 'youtube.com') !== false){
        $return = preg_replace('@embed/([^"&]*)@', 'embed/$1&showinfo=0&autoplay=1', $code);
        return '<div class="embed-container">' . $return . '</div>';
    return '<div class="embed-container">' . $code . '</div>';

add_filter( 'embed_oembed_html', 'embed_responsive_autoplay');
add_filter( 'video_embed_html', 'embed_responsive_autoplay' ); // Jetpack


  • Please don't dump a code block, perhaps edit and add some explanation to it. Dec 13, 2014 at 5:01

Cross-posting my answer from https://stackoverflow.com/a/55053642/799327, hope that's okay since it's from the same OP:

So, after some research on this, the best way to do this is to leverage the oembed_fetch_url filter hook to add extra arguments to the oEmbed request URL. My specific goal was to allow an autoplay paramater, but this method is built to be easy to tailor to any oEmbed argument you need.

First, add this to your functions.php:

 * Add parameters to embed
 * @src https://foxland.fi/adding-parameters-to-wordpress-oembed/
 * @src https://github.com/WordPress/WordPress/blob/ec417a34a7ce0d10a998b7eb6d50d7ba6291d94d/wp-includes/class-oembed.php#L553
$allowed_args = ['autoplay'];

function koa_oembed_args($provider, $url, $args) {
    global $allowed_args;

    $filtered_args = array_filter(
        function ($key) use ($allowed_args) {
            return in_array($key, $allowed_args);

    foreach ($filtered_args as $key => $value) {
        $provider = add_query_arg($key, $value, $provider);

    return $provider;

add_filter('oembed_fetch_url', 'koa_oembed_args', 10, 3);

This function takes the generated oEmbed URL and its corresponding arguments and checks it agains a hard-coded list of whitelisted arguments, in this case ['autoplay']. If it sees any of these whitelisted keywords in the arguments passed to the oEmbed filter, it adds them with their given value to the oEmbed URL.

Then, all you need to do is add the oEmbed parameter to your shortcode in the Wordpress editor, like this:

[embed autoplay="true"]https://vimeo.com/1234567890/1234567890[/embed]

Be aware that the oEmbed class in WP uses the postmeta as a cache for these requests, so if you've embedded the target URL before, you might have to clear your postmeta cache in some way or add a cache buster of some kind to the target URL. If the link is in the cache, the filter hook will never get to run.

I hope this makes sense, as I feel like it's a pretty useful feature that's surprisingly hard to figure out how to achieve.


Anything after the first parameter must be sent as an array of arguments.

See the example given on the codex page.

If you're attempting to take a custom field value and have the embed code convert it into a video(ie. what would happen if you placed it into the content), then you can do something like this...

   N - replace with a valid post ID
   key - replace with a valid custom field key(name)
$data = get_post_meta( N, 'key', true );
if( $data )
   echo apply_filters( 'the_content', $data );

This of course will run several filters over the data that you don't need, but it does the trick all the same..

  • 1
    Unfortunately, the only arguments that wp_oembed_get will listen to are 'width' and 'height' Dec 14, 2010 at 21:00
  • Guess there's no passing in that arg then.. at least not using wp_oembed_get ..
    – t31os
    Dec 14, 2010 at 21:10
  • Yeah; as far as I know (although I could be wrong about this) youtube's oEmbed API doesn't allow for that argument at all. Dec 14, 2010 at 21:56
  • I did a little digging into the embed, and as far as i can tell(like you said) the only args that get passed along are height and width.. (easy to test, call the func with an array passed in, doesn't work with autoplay, width and height work though).
    – t31os
    Dec 14, 2010 at 22:05
  • Thanks everyone, I will have to look into another solution.
    – criticerz
    Dec 15, 2010 at 4:44

After all research what i found is this. below is the code.

function iweb_modest_youtube_player( $html, $url, $args ) {
    return str_replace( '?feature=oembed', '? 
    feature=oembed&modestbranding=1&showinfo=0&rel=0', $html );
add_filter( 'oembed_result', 'iweb_modest_youtube_player', 10, 3 );

Credits to https://gist.github.com/mustardBees/7704269#file-functions-php.



This can be easily fixed by modifying the wp_oembed_get() function in wp-includes/media.php to this:

function wp_oembed_get( $url, $args = '' ) {
    // Manually build the IFRAME embed with the related videos option disabled and autoplay turned on
    if(preg_match("/youtube.com\/watch\?v=([^&]+)/i", $url, $aMatch)){
        return '<iframe width="560" height="315" src="http://www.youtube.com/embed/' . $aMatch[1] . '?rel=0&autoplay=1" frameborder="0" allowfullscreen></iframe>';

    require_once( ABSPATH . WPINC . '/class-oembed.php' );
    $oembed = _wp_oembed_get_object();
    return $oembed->get_html( $url, $args );
  • Also, be sure to run the following SQL query after you make this change so that the embed is refreshed: DELETE FROM wp_postmeta WHERE meta_key LIKE '_oembed_%' Apr 12, 2012 at 7:38
  • 2
    You cannot update WP anymore after you doing this. Not recommended.
    – fuxia
    Apr 13, 2012 at 1:32
  • 3
    Modifying core is just a bad idea. Apr 1, 2013 at 17:57

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.