split_the_query filter-hookWP 3.4.0

Filters whether to split the query.

Splitting the query will cause it to fetch just the IDs of the found posts (and then individually fetch each post by ID), rather than fetching every complete row at once. One massive result vs. many small results.


add_filter( 'split_the_query', 'wp_kama_split_the_query_filter', 10, 2 );

 * Function for `split_the_query` filter-hook.
 * @param bool     $split_the_query Whether or not to split the query.
 * @param WP_Query $query           The WP_Query instance.
 * @return bool
function wp_kama_split_the_query_filter( $split_the_query, $query ){

	// filter...
	return $split_the_query;
Whether or not to split the query.
The WP_Query instance.


Since 3.4.0 Introduced.

Where the hook is called

wp-includes/class-wp-query.php 3305
$split_the_query = apply_filters( 'split_the_query', $split_the_query, $this );

Where the hook is used in WordPress

Usage not found.