Exciting News! Flipper Code is now WePlugins! Same commitment to excellence, brand new identity.

How to use posts_distinct_request filter in WordPress

Sandeep Kumar Mishra
Sandeep Kumar Mishra
July 11, 2022
5 minutes read

posts_distinct_request filter

Filters the DISTINCT clause of the query.

apply_filters_ref_array( 'posts_distinct_request', string $distinct, WP_Query $query )


This is filter hook , its filter the DISTINCT clause of the query.
For use by caching plugins.
Its consists of two parameters, one is $clauses, second is $query.


  • $distinct : (string) The DISTINCT clause of the query.
  • $query : (WP_Query) The WP_Query instance (passed by reference).

Live Example

To run the hook, copy the example below.

$distinct = apply_filters( 'posts_distinct_request', $distinct, $query ); 
if ( !empty( $distinct ) ) { 
   // everything has led up to this point... 

The following example is for adding a hook callback.

// define the posts_distinct_request callback 
function filter_posts_distinct_request( $distinct, $query  ) { 
    // make filter magic happen here... 
    return $distinct; 
// add the filter 
add_filter( 'posts_distinct_request', 'filter_posts_distinct_request', 10, 1 ); 

To remove a hook callback, use the example below.

// remove the filter 
remove_filter( 'posts_distinct_request', 'filter_posts_distinct_request', 10, 1 ); 
Sandeep Kumar Mishra

Sandeep Kumar Mishra writes about WordPress and Artificial Intelligence, offering tips and guides to help you master your website and stay updated with the latest tech trends.

Explore the latest in WordPress

Trying to stay on top of it all? Get the best tools, resources and inspiration sent to your inbox every Wednesday.