is_embed() │ WP 4.4.0

Is the query for an embedded post?

Uses: WP_Query::is_embed()
1 time — 0.000019 sec (very fast) | 50000 times — 0.02 sec (speed of light) | PHP 7.1.2, WP 4.7.3

No Hooks.

Return

true|false. Whether the query is for an embedded post.

Usage

is_embed();

Examples

0

#1 Add text to the footer on all pages except embeds 

add_action( 'wp_footer', 'add_footer_text' );

function add_footer_text() {

	// skip the embeds
	if ( is_embed() ) {
		return;
	}

	echo 'some text';
}

Notes

  • Global. WP_Query. $wp_query WordPress Query object.

Changelog

Since 4.4.0 Introduced.

is_embed() code WP 6.7.1

wp-includes/query.php 
function is_embed() {
	global $wp_query;

	if ( ! isset( $wp_query ) ) {
		_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
		return false;
	}

	return $wp_query->is_embed();
}

oEmbed (WP response to embed request)

Conditional tags (page type and request)

Conditional tags (all)

Main Query

Main Functions