WordPress at a glance

is_main_query() WP 1.0

Is the query the main query?

For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.

  • Global. WP_Query. $wp_query Global WP_Query instance.
✈ 1 time = 0.000011s = very fast | 50000 times = 0.01s = speed of light PHP 7.0.14, WP 4.7

No Hooks.

Return

true/false.

Usage

is_main_query();

Code of is_main_query: wp-includes/query.php VER 5.0.1

<?php
function is_main_query() {
	if ( 'pre_get_posts' === current_filter() ) {
		$message = sprintf(
			/* translators: 1: pre_get_posts 2: WP_Query->is_main_query() 3: is_main_query() 4: link to codex is_main_query() page. */
			__( 'In %1$s, use the %2$s method, not the %3$s function. See %4$s.' ),
			'<code>pre_get_posts</code>',
			'<code>WP_Query->is_main_query()</code>',
			'<code>is_main_query()</code>',
			__( 'https://codex.wordpress.org/Function_Reference/is_main_query' )
		);
		_doing_it_wrong( __FUNCTION__, $message, '3.7.0' );
	}

	global $wp_query;
	return $wp_query->is_main_query();
}

Related Functions

From tag: Conditional tags (all)

More from category: Queries

No comments
    Hello, !     Log In . Register