WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

found_posts

apply_filters_ref_array( ‘found_posts’, int $found_posts, WP_Query $query )

In this article

Back to top

Filters the number of found posts for the query.

Parameters

$found_postsint
The number of posts found.
$queryWP_Query
The WP_Query instance (passed by reference).

More Information

This filter hook allows developers to adjust the number of posts that WordPress’s WP_Query class reports finding when it runs a query.

This hook is especially useful when developing custom pagination. For instance, if you are declaring a custom offset value in your queries, WordPress will NOT deduct the offset from the the $wp_query->found_posts parameter (for example, if you have 45 usable posts after an offset of 10, WordPress will ignore the offset and still give found_posts a value of 55).

Make sure you haven’t passed no_found_rows in query arguments, Otherwise you will receive a 0 value in return.

Source

$this->found_posts = (int) apply_filters_ref_array( 'found_posts', array( $this->found_posts, &$this ) );

View all references View on Trac View on GitHub

Used byDescription
WP_Query::set_found_posts()wp-includes/class-wp-query.php

Sets up the amount of found posts and the number of pages (if limit clause was used) for the current query.

Changelog

VersionDescription
2.1.0Introduced.

User Contributed Notes

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