Title: WP_oEmbed::get_html
Published: April 25, 2014
Last modified: August 20, 2026

---

# WP_oEmbed::get_html( string $url, string|array $args = '' ): string|false

## In this article

 * [Description](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#description)
    - [See also](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#see-also)
 * [Parameters](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#source)
 * [Hooks](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#hooks)
 * [Related](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#wp--skip-link--target)

The do-it-all function that takes a URL and attempts to return the HTML.

## 󠀁[Description](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#description)󠁿

### 󠀁[See also](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#see-also)󠁿

 * [WP_oEmbed::fetch()](https://developer.wordpress.org/reference/classes/WP_oEmbed/fetch/)
 * [WP_oEmbed::data2html()](https://developer.wordpress.org/reference/classes/WP_oEmbed/data2html/)

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#parameters)󠁿

 `$url`stringrequired

The URL to the content that should be attempted to be embedded.

`$args`string|arrayoptional

Additional arguments for retrieving embed HTML.
 See [wp_oembed_get()](https://developer.wordpress.org/reference/functions/wp_oembed_get/)
for accepted arguments.

More Arguments from wp_oembed_get( … $args )

Additional arguments for retrieving embed HTML.

 * `width` int|string
 * Optional. The `maxwidth` value passed to the provider URL.
 * `height` int|string
 * Optional. The `maxheight` value passed to the provider URL.
 * `discover` bool
 * Optional. Determines whether to attempt to discover link tags at the given URL
   for an oEmbed provider when the provider URL is not found in the built-in providers
   list. Default true.

Default:`''`

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#return)󠁿

 string|false The UNSANITIZED (and potentially unsafe) HTML that should be used 
to embed on success, false on failure.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#source)󠁿

    ```php
    public function get_html( $url, $args = '' ) {
    	/**
    	 * Filters the oEmbed result before any HTTP requests are made.
    	 *
    	 * This allows one to short-circuit the default logic, perhaps by
    	 * replacing it with a routine that is more optimal for your setup.
    	 *
    	 * Returning a non-null value from the filter will effectively short-circuit retrieval
    	 * and return the passed value instead.
    	 *
    	 * @since 4.5.3
    	 *
    	 * @param null|string  $result The UNSANITIZED (and potentially unsafe) HTML that should be used to embed.
    	 *                             Default null to continue retrieving the result.
    	 * @param string       $url    The URL to the content that should be attempted to be embedded.
    	 * @param string|array $args   Optional. Additional arguments for retrieving embed HTML.
    	 *                             See wp_oembed_get() for accepted arguments. Default empty.
    	 */
    	$pre = apply_filters( 'pre_oembed_result', null, $url, $args );

    	if ( null !== $pre ) {
    		return $pre;
    	}

    	$data = $this->get_data( $url, $args );

    	if ( false === $data ) {
    		return false;
    	}

    	/**
    	 * Filters the HTML returned by the oEmbed provider.
    	 *
    	 * @since 2.9.0
    	 *
    	 * @param string|false $data The returned oEmbed HTML (false if unsafe).
    	 * @param string       $url  URL of the content to be embedded.
    	 * @param string|array $args Optional. Additional arguments for retrieving embed HTML.
    	 *                           See wp_oembed_get() for accepted arguments. Default empty.
    	 */
    	return apply_filters( 'oembed_result', $this->data2html( $data, $url ), $url, $args );
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-oembed.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.1/src/wp-includes/class-wp-oembed.php#L442)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.1/src/wp-includes/class-wp-oembed.php#L442-L483)

## 󠀁[Hooks](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#hooks)󠁿

 [apply_filters( ‘oembed_result’, string|false $data, string $url, string|array $args )](https://developer.wordpress.org/reference/hooks/oembed_result/)

Filters the HTML returned by the oEmbed provider.

 [apply_filters( ‘pre_oembed_result’, null|string $result, string $url, string|array $args )](https://developer.wordpress.org/reference/hooks/pre_oembed_result/)

Filters the oEmbed result before any HTTP requests are made.

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#related)󠁿

| Uses | Description | 
| [WP_oEmbed::get_data()](https://developer.wordpress.org/reference/classes/wp_oembed/get_data/)`wp-includes/class-wp-oembed.php` |

Takes a URL and attempts to return the oEmbed data.

  | 
| [WP_oEmbed::data2html()](https://developer.wordpress.org/reference/classes/wp_oembed/data2html/)`wp-includes/class-wp-oembed.php` |

Converts a data object from [WP_oEmbed::fetch()](https://developer.wordpress.org/reference/classes/wp_oembed/fetch/) and returns the HTML.

  | 
| [apply_filters()](https://developer.wordpress.org/reference/functions/apply_filters/)`wp-includes/plugin.php` |

Calls the callback functions that have been added to a filter hook.

  |

[Show 1 more](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#)
[Show less](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#)

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_oembed/get_html/?output_format=md#changelog)󠁿

| Version | Description | 
| [2.9.0](https://developer.wordpress.org/reference/since/2.9.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_oembed%2Fget_html%2F)
before being able to contribute a note or feedback.