apply_filters( 'pre_oembed_result', null|string $result, string $url, array $args )

Filters the oEmbed result before any HTTP requests are made.

Description Description

This allows one to short-circuit the default logic, perhaps by replacing it with a routine that is more optimal for your setup.

Passing a non-null value to the filter will effectively short-circuit retrieval, returning the passed value instead.

Parameters Parameters


(null|string) The UNSANITIZED (and potentially unsafe) HTML that should be used to embed. Default null.


(string) The URL to the content that should be attempted to be embedded.


(array) Arguments, usually passed from a shortcode. Default empty.

Top ↑

Source Source

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

View on Trac

Top ↑

Changelog Changelog

Version Description
4.5.3 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

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