wp_embed_handler_youtube()WP 4.0.0

YouTube iframe embed handler callback.

Catches YouTube iframe embed URLs that are not parsable by oEmbed but can be translated into a URL that is.

Hooks from the function


String. The embed HTML.


wp_embed_handler_youtube( $matches, $attr, $url, $rawattr );
$matches(array) (required)
The RegEx matches from the provided regex when calling wp_embed_register_handler().
$attr(array) (required)
Embed attributes.
$url(string) (required)
The original URL that was matched by the regex.
$rawattr(array) (required)
The original unmodified attributes.


  • Global. WP_Embed. $wp_embed


Since 4.0.0 Introduced.

wp_embed_handler_youtube() code WP 6.3

function wp_embed_handler_youtube( $matches, $attr, $url, $rawattr ) {
	global $wp_embed;
	$embed = $wp_embed->autoembed( sprintf( 'https://youtube.com/watch?v=%s', urlencode( $matches[2] ) ) );

	 * Filters the YoutTube embed output.
	 * @since 4.0.0
	 * @see wp_embed_handler_youtube()
	 * @param string $embed   YouTube embed output.
	 * @param array  $attr    An array of embed attributes.
	 * @param string $url     The original URL that was matched by the regex.
	 * @param array  $rawattr The original unmodified attributes.
	return apply_filters( 'wp_embed_handler_youtube', $embed, $attr, $url, $rawattr );