{"pageProps":{"title":"found_posts_query","titleType":"Hook","type":"hooks","content":"<article><h1>found_posts_query <span>WordPress Filter Hook</span></h1><p class=\"main-description\">The found_posts_query hook is triggered when a search is performed on a WordPress site. It allows developers to modify the SQL query used to search the WordPress database. This hook is useful for creating a custom search engine or for optimizing the search results displayed on a WordPress site.</p><h2><span class=\"hook-func\">apply_filters_ref_array</span>( 'found_posts_query',  <nobr><span class=\"arg-type\">string</span> <span class=\"arg-name\">$found_posts_query</span></nobr>,  <nobr><span class=\"arg-type\">WP_Query</span> <span class=\"arg-name\">$query</span></nobr> ) <a id=\"block-level-html-elements-by-default\" href=\"#found_posts_query\">#</a></h2><section class=\"summary\"><p>Filters the query to run for retrieving the found posts.</p></section><div class=\"content-toc\"><div class=\"table-of-contents\"><h2>Contents</h2><ul class=\"items\"><li><a href=\"#parameters\">Parameters</a></li><li><a href=\"#source\">Source</a></li><li><a href=\"#related\">Related</a><ul><li><a href=\"#used-by\">Used By</a></ul></li><li><a href=\"#changelog\">Changelog</a></li></ul></div><hr /><section class=\"parameters\"><h2 id=\"parameters\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#parameters\" class=\"dashicons-before dashicons-admin-links\">Parameters</a></h2><dl><dt>$found_posts_query</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"string\">string</span>)</span><span class=\"description\">The query to run to find the found posts.</span></p></dd><dt>$query</dt><dd><p class=\"desc\"><span class=\"type\">(<span class=\"WP_Query\"><a href=\"/reference/classes/wp_query\">WP_Query</a></span>)</span><span class=\"description\">The <a href=\"/reference/classes/wp_query\">WP_Query</a> instance (passed by reference).</span></p></dd></dl></section><hr /><section class=\"source-content\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h2 id=\"source\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#source\" class=\"dashicons-before dashicons-admin-links\">Source</a></h2><p>File: <a href=\"/reference/files/wp-includes/class-wp-query.php\">wp-includes/class-wp-query.php</a></p><p><a href=\"https://core.trac.wordpress.org/browser/tags/6.0/src/wp-includes/class-wp-query.php#L3379\">View on Trac</a></p></section><hr /><section class=\"related\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h2 id=\"related\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#related\" class=\"dashicons-before dashicons-admin-links\">Related</a></h2><article class=\"used-by\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h3 id=\"used-by\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#used-by\" class=\"dashicons-before dashicons-admin-links\">Used By</a></h3><table id=\"used-by-table\"><caption class=\"screen-reader-text\">Used By</caption><thead><tr><th>Used By</th><th class=\"related-desc\">Description</th></tr></thead><tbody><tr><td><span>wp-includes/class-wp-query.php:</span><a href=\"/reference/classes/wp_query/set_found_posts\">WP_Query::set_found_posts()</a></td><td class=\"related-desc\"><p>Set up the amount of found posts and the number of pages (if limit clause was used) for the current query.</p></td></tr><tbody></table></article></section><hr /><section class=\"changelog\"><p class=\"toc-jump\"><a href=\"#top\">Top &uarr;</a></p><h2 id=\"changelog\" class=\"toc-heading\" tabindex=\"-1\" ><a href=\"#changelog\" class=\"dashicons-before dashicons-admin-links\">Changelog</a></h2><table><caption class=\"screen-reader-text\">Changelog</caption><thead><tr><th class=\"changelog-version\">Version</th><th class=\"changelog-desc\">Description</th></tr></thead><tbody><tr><td><a href=\"/reference/since/2.1.0\" alt=\"WordPress 2.1.0\">2.1.0</a></td><td>Introduced.</td></tr></tbody></table></section></div></article>","description":"Filters the query to run for retrieving the found posts.","sidebarFiles":{"Hook":[{"componentTitle":"comment_feed_groupby","componentLink":"/reference/hooks/comment_feed_groupby","private":"","deprecated":""},{"componentTitle":"comment_feed_join","componentLink":"/reference/hooks/comment_feed_join","private":"","deprecated":""},{"componentTitle":"comment_feed_limits","componentLink":"/reference/hooks/comment_feed_limits","private":"","deprecated":""},{"componentTitle":"comment_feed_orderby","componentLink":"/reference/hooks/comment_feed_orderby","private":"","deprecated":""},{"componentTitle":"comment_feed_where","componentLink":"/reference/hooks/comment_feed_where","private":"","deprecated":""},{"componentTitle":"comment_loop_start","componentLink":"/reference/hooks/comment_loop_start","private":"","deprecated":""},{"componentTitle":"content_pagination","componentLink":"/reference/hooks/content_pagination","private":"","deprecated":""},{"componentTitle":"found_posts","componentLink":"/reference/hooks/found_posts","private":"","deprecated":""},{"componentTitle":"found_posts_query","componentLink":"/reference/hooks/found_posts_query","private":"","deprecated":"","active":"active"},{"componentTitle":"loop_end","componentLink":"/reference/hooks/loop_end","private":"","deprecated":""},{"componentTitle":"loop_no_results","componentLink":"/reference/hooks/loop_no_results","private":"","deprecated":""},{"componentTitle":"loop_start","componentLink":"/reference/hooks/loop_start","private":"","deprecated":""},{"componentTitle":"parse_query","componentLink":"/reference/hooks/parse_query","private":"","deprecated":""},{"componentTitle":"parse_tax_query","componentLink":"/reference/hooks/parse_tax_query","private":"","deprecated":""},{"componentTitle":"post_limits","componentLink":"/reference/hooks/post_limits","private":"","deprecated":""},{"componentTitle":"post_limits_request","componentLink":"/reference/hooks/post_limits_request","private":"","deprecated":""},{"componentTitle":"posts_clauses","componentLink":"/reference/hooks/posts_clauses","private":"","deprecated":""},{"componentTitle":"posts_clauses_request","componentLink":"/reference/hooks/posts_clauses_request","private":"","deprecated":""},{"componentTitle":"posts_distinct","componentLink":"/reference/hooks/posts_distinct","private":"","deprecated":""},{"componentTitle":"posts_distinct_request","componentLink":"/reference/hooks/posts_distinct_request","private":"","deprecated":""},{"componentTitle":"posts_fields","componentLink":"/reference/hooks/posts_fields","private":"","deprecated":""},{"componentTitle":"posts_fields_request","componentLink":"/reference/hooks/posts_fields_request","private":"","deprecated":""},{"componentTitle":"posts_groupby","componentLink":"/reference/hooks/posts_groupby","private":"","deprecated":""},{"componentTitle":"posts_groupby_request","componentLink":"/reference/hooks/posts_groupby_request","private":"","deprecated":""},{"componentTitle":"posts_join","componentLink":"/reference/hooks/posts_join","private":"","deprecated":""},{"componentTitle":"posts_join_paged","componentLink":"/reference/hooks/posts_join_paged","private":"","deprecated":""},{"componentTitle":"posts_join_request","componentLink":"/reference/hooks/posts_join_request","private":"","deprecated":""},{"componentTitle":"posts_orderby","componentLink":"/reference/hooks/posts_orderby","private":"","deprecated":""},{"componentTitle":"posts_orderby_request","componentLink":"/reference/hooks/posts_orderby_request","private":"","deprecated":""},{"componentTitle":"posts_pre_query","componentLink":"/reference/hooks/posts_pre_query","private":"","deprecated":""},{"componentTitle":"posts_request","componentLink":"/reference/hooks/posts_request","private":"","deprecated":""},{"componentTitle":"posts_request_ids","componentLink":"/reference/hooks/posts_request_ids","private":"","deprecated":""},{"componentTitle":"posts_results","componentLink":"/reference/hooks/posts_results","private":"","deprecated":""},{"componentTitle":"posts_search","componentLink":"/reference/hooks/posts_search","private":"","deprecated":""},{"componentTitle":"posts_search_orderby","componentLink":"/reference/hooks/posts_search_orderby","private":"","deprecated":""},{"componentTitle":"posts_selection","componentLink":"/reference/hooks/posts_selection","private":"","deprecated":""},{"componentTitle":"posts_where","componentLink":"/reference/hooks/posts_where","private":"","deprecated":""},{"componentTitle":"posts_where_paged","componentLink":"/reference/hooks/posts_where_paged","private":"","deprecated":""},{"componentTitle":"posts_where_request","componentLink":"/reference/hooks/posts_where_request","private":"","deprecated":""},{"componentTitle":"pre_get_posts","componentLink":"/reference/hooks/pre_get_posts","private":"","deprecated":""},{"componentTitle":"set_404","componentLink":"/reference/hooks/set_404","private":"","deprecated":""},{"componentTitle":"split_the_query","componentLink":"/reference/hooks/split_the_query","private":"","deprecated":""},{"componentTitle":"the_post","componentLink":"/reference/hooks/the_post","private":"","deprecated":""},{"componentTitle":"the_posts","componentLink":"/reference/hooks/the_posts","private":"","deprecated":""},{"componentTitle":"the_preview","componentLink":"/reference/hooks/the_preview","private":"","deprecated":""},{"componentTitle":"wp_query_search_exclusion_prefix","componentLink":"/reference/hooks/wp_query_search_exclusion_prefix","private":"","deprecated":""},{"componentTitle":"wp_search_stopwords","componentLink":"/reference/hooks/wp_search_stopwords","private":"","deprecated":""}],"Class":[{"componentTitle":"WP_Query","componentLink":"/reference/classes/wp_query","private":"","deprecated":""}],"Class Method":[{"componentTitle":"WP_Query::__call()","componentLink":"/reference/classes/wp_query/__call","private":"","deprecated":""},{"componentTitle":"WP_Query::__construct()","componentLink":"/reference/classes/wp_query/__construct","private":"","deprecated":""},{"componentTitle":"WP_Query::__get()","componentLink":"/reference/classes/wp_query/__get","private":"","deprecated":""},{"componentTitle":"WP_Query::__isset()","componentLink":"/reference/classes/wp_query/__isset","private":"","deprecated":""},{"componentTitle":"WP_Query::fill_query_vars()","componentLink":"/reference/classes/wp_query/fill_query_vars","private":"","deprecated":""},{"componentTitle":"WP_Query::generate_postdata()","componentLink":"/reference/classes/wp_query/generate_postdata","private":"","deprecated":""},{"componentTitle":"WP_Query::get_posts()","componentLink":"/reference/classes/wp_query/get_posts","private":"","deprecated":""},{"componentTitle":"WP_Query::get_queried_object_id()","componentLink":"/reference/classes/wp_query/get_queried_object_id","private":"","deprecated":""},{"componentTitle":"WP_Query::get_queried_object()","componentLink":"/reference/classes/wp_query/get_queried_object","private":"","deprecated":""},{"componentTitle":"WP_Query::get_search_stopwords()","componentLink":"/reference/classes/wp_query/get_search_stopwords","private":"","deprecated":""},{"componentTitle":"WP_Query::get()","componentLink":"/reference/classes/wp_query/get","private":"","deprecated":""},{"componentTitle":"WP_Query::have_comments()","componentLink":"/reference/classes/wp_query/have_comments","private":"","deprecated":""},{"componentTitle":"WP_Query::have_posts()","componentLink":"/reference/classes/wp_query/have_posts","private":"","deprecated":""},{"componentTitle":"WP_Query::init_query_flags()","componentLink":"/reference/classes/wp_query/init_query_flags","private":"private","deprecated":""},{"componentTitle":"WP_Query::init()","componentLink":"/reference/classes/wp_query/init","private":"","deprecated":""},{"componentTitle":"WP_Query::is_404()","componentLink":"/reference/classes/wp_query/is_404","private":"","deprecated":""},{"componentTitle":"WP_Query::is_archive()","componentLink":"/reference/classes/wp_query/is_archive","private":"","deprecated":""},{"componentTitle":"WP_Query::is_attachment()","componentLink":"/reference/classes/wp_query/is_attachment","private":"","deprecated":""},{"componentTitle":"WP_Query::is_author()","componentLink":"/reference/classes/wp_query/is_author","private":"","deprecated":""},{"componentTitle":"WP_Query::is_category()","componentLink":"/reference/classes/wp_query/is_category","private":"","deprecated":""},{"componentTitle":"WP_Query::is_comment_feed()","componentLink":"/reference/classes/wp_query/is_comment_feed","private":"","deprecated":""},{"componentTitle":"WP_Query::is_comments_popup()","componentLink":"/reference/classes/wp_query/is_comments_popup","private":"","deprecated":"deprecated"},{"componentTitle":"WP_Query::is_date()","componentLink":"/reference/classes/wp_query/is_date","private":"","deprecated":""},{"componentTitle":"WP_Query::is_day()","componentLink":"/reference/classes/wp_query/is_day","private":"","deprecated":""},{"componentTitle":"WP_Query::is_embed()","componentLink":"/reference/classes/wp_query/is_embed","private":"","deprecated":""},{"componentTitle":"WP_Query::is_favicon()","componentLink":"/reference/classes/wp_query/is_favicon","private":"","deprecated":""},{"componentTitle":"WP_Query::is_feed()","componentLink":"/reference/classes/wp_query/is_feed","private":"","deprecated":""},{"componentTitle":"WP_Query::is_front_page()","componentLink":"/reference/classes/wp_query/is_front_page","private":"","deprecated":""},{"componentTitle":"WP_Query::is_home()","componentLink":"/reference/classes/wp_query/is_home","private":"","deprecated":""},{"componentTitle":"WP_Query::is_main_query()","componentLink":"/reference/classes/wp_query/is_main_query","private":"","deprecated":""},{"componentTitle":"WP_Query::is_month()","componentLink":"/reference/classes/wp_query/is_month","private":"","deprecated":""},{"componentTitle":"WP_Query::is_page()","componentLink":"/reference/classes/wp_query/is_page","private":"","deprecated":""},{"componentTitle":"WP_Query::is_paged()","componentLink":"/reference/classes/wp_query/is_paged","private":"","deprecated":""},{"componentTitle":"WP_Query::is_post_type_archive()","componentLink":"/reference/classes/wp_query/is_post_type_archive","private":"","deprecated":""},{"componentTitle":"WP_Query::is_preview()","componentLink":"/reference/classes/wp_query/is_preview","private":"","deprecated":""},{"componentTitle":"WP_Query::is_privacy_policy()","componentLink":"/reference/classes/wp_query/is_privacy_policy","private":"","deprecated":""},{"componentTitle":"WP_Query::is_robots()","componentLink":"/reference/classes/wp_query/is_robots","private":"","deprecated":""},{"componentTitle":"WP_Query::is_search()","componentLink":"/reference/classes/wp_query/is_search","private":"","deprecated":""},{"componentTitle":"WP_Query::is_single()","componentLink":"/reference/classes/wp_query/is_single","private":"","deprecated":""},{"componentTitle":"WP_Query::is_singular()","componentLink":"/reference/classes/wp_query/is_singular","private":"","deprecated":""},{"componentTitle":"WP_Query::is_tag()","componentLink":"/reference/classes/wp_query/is_tag","private":"","deprecated":""},{"componentTitle":"WP_Query::is_tax()","componentLink":"/reference/classes/wp_query/is_tax","private":"","deprecated":""},{"componentTitle":"WP_Query::is_time()","componentLink":"/reference/classes/wp_query/is_time","private":"","deprecated":""},{"componentTitle":"WP_Query::is_trackback()","componentLink":"/reference/classes/wp_query/is_trackback","private":"","deprecated":""},{"componentTitle":"WP_Query::is_year()","componentLink":"/reference/classes/wp_query/is_year","private":"","deprecated":""},{"componentTitle":"WP_Query::lazyload_comment_meta()","componentLink":"/reference/classes/wp_query/lazyload_comment_meta","private":"","deprecated":"deprecated"},{"componentTitle":"WP_Query::lazyload_term_meta()","componentLink":"/reference/classes/wp_query/lazyload_term_meta","private":"","deprecated":"deprecated"},{"componentTitle":"WP_Query::next_comment()","componentLink":"/reference/classes/wp_query/next_comment","private":"","deprecated":""},{"componentTitle":"WP_Query::next_post()","componentLink":"/reference/classes/wp_query/next_post","private":"","deprecated":""},{"componentTitle":"WP_Query::parse_order()","componentLink":"/reference/classes/wp_query/parse_order","private":"","deprecated":""},{"componentTitle":"WP_Query::parse_orderby()","componentLink":"/reference/classes/wp_query/parse_orderby","private":"","deprecated":""},{"componentTitle":"WP_Query::parse_query_vars()","componentLink":"/reference/classes/wp_query/parse_query_vars","private":"","deprecated":""},{"componentTitle":"WP_Query::parse_query()","componentLink":"/reference/classes/wp_query/parse_query","private":"","deprecated":""},{"componentTitle":"WP_Query::parse_search_order()","componentLink":"/reference/classes/wp_query/parse_search_order","private":"","deprecated":""},{"componentTitle":"WP_Query::parse_search_terms()","componentLink":"/reference/classes/wp_query/parse_search_terms","private":"","deprecated":""},{"componentTitle":"WP_Query::parse_search()","componentLink":"/reference/classes/wp_query/parse_search","private":"","deprecated":""},{"componentTitle":"WP_Query::parse_tax_query()","componentLink":"/reference/classes/wp_query/parse_tax_query","private":"","deprecated":""},{"componentTitle":"WP_Query::query()","componentLink":"/reference/classes/wp_query/query","private":"","deprecated":""},{"componentTitle":"WP_Query::reset_postdata()","componentLink":"/reference/classes/wp_query/reset_postdata","private":"","deprecated":""},{"componentTitle":"WP_Query::rewind_comments()","componentLink":"/reference/classes/wp_query/rewind_comments","private":"","deprecated":""},{"componentTitle":"WP_Query::rewind_posts()","componentLink":"/reference/classes/wp_query/rewind_posts","private":"","deprecated":""},{"componentTitle":"WP_Query::set_404()","componentLink":"/reference/classes/wp_query/set_404","private":"","deprecated":""},{"componentTitle":"WP_Query::set_found_posts()","componentLink":"/reference/classes/wp_query/set_found_posts","private":"private","deprecated":""},{"componentTitle":"WP_Query::set()","componentLink":"/reference/classes/wp_query/set","private":"","deprecated":""},{"componentTitle":"WP_Query::setup_postdata()","componentLink":"/reference/classes/wp_query/setup_postdata","private":"","deprecated":""},{"componentTitle":"WP_Query::the_comment()","componentLink":"/reference/classes/wp_query/the_comment","private":"","deprecated":""},{"componentTitle":"WP_Query::the_post()","componentLink":"/reference/classes/wp_query/the_post","private":"","deprecated":""}]}},"__N_SSG":true}