apply_filters( 'oembed_result', string|false $data, string $url, string|array $args )

Filters the HTML returned by the oEmbed provider.



(string|false) The returned oEmbed HTML (false if unsafe).


(string) URL of the content to be embedded.


(string|array) Additional arguments for retrieving embed HTML. See wp_oembed_get() for accepted arguments. Default empty.

Top ↑


File: wp-includes/class-wp-oembed.php

View on Trac

Top ↑


Version Description
2.9.0 Introduced.

Top ↑

User Contributed Notes

  1. Skip to note 1 content
    Contributed by AndyDeGroo

    In case you are wondering why this filter does not work for you:
    The oembed_result filter is applied before the oEmbed response is cached as _oembed_* meta entry in the postmeta table.
    If you want to always modify the oembed HTML, you should look at embed_oembed_html filter.
    However, using the `embed_oembed_html` filter may reduce site’s performance, because it is called on every page load for every embed URL.

You must log in before being able to contribute a note or feedback.