WordPress.org

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

Filters the HTML returned by the oEmbed provider.

Contents

Parameters
Source
Related
- Used By
Changelog
User Contributed Notes

Parameters Parameters

$data: (string|false) The returned oEmbed HTML (false if unsafe).
$url: (string) URL of the content to be embedded.
$args: (array) arguments, usually passed from a shortcode.

Source Source

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

Used By Used By

Used By
Used By	Description
wp-includes/class-wp-oembed-controller.php: WP_oEmbed_Controller::get_proxy_item()	Callback for the proxy API endpoint.
wp-includes/class-wp-oembed.php: WP_oEmbed::get_html()	The do-it-all function that takes a URL and attempts to return the HTML.

Changelog Changelog

Changelog
Version	Description
2.9.0	Introduced.

User Contributed Notes User Contributed Notes

Skip to note 1 content

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note

Contributed by AndyDeGroo — 3 years ago

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.

Log in to add feedback

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