is_main_query()
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.
1 time — 0.000011 sec (very fast) | 50000 times — 0.01 sec (speed of light) | PHP 7.0.14, WP 4.7
No Hooks.
Return
true|false
. Whether the query is the main query.
Usage
is_main_query();
Notes
- Global. WP_Query. $wp_query WordPress Query object.
Changelog
Since 3.3.0 | Introduced. |
Code of is_main_query() is main query WP 5.9.3
function is_main_query() { global $wp_query; if ( 'pre_get_posts' === current_filter() ) { _doing_it_wrong( __FUNCTION__, sprintf( /* translators: 1: pre_get_posts, 2: WP_Query->is_main_query(), 3: is_main_query(), 4: Documentation URL. */ __( '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://developer.wordpress.org/reference/functions/is_main_query/' ) ), '3.7.0' ); } return $wp_query->is_main_query(); }