Filters the query $args used by WP_Query to display posts in the Post Object field.


  • Added in version 4.1.2


apply_filters( 'acf/fields/post_object/query', $args, $field, $post_id );
  • $args (array) The query args. See WP_Query for available args.
  • $field (array) The field array containing all settings.
  • $post_id (int|string) The current post ID being edited.


This filter provides modifiers to target specific fields. The following filter names are available:

  • acf/fields/post_object/query Applies to all fields.
  • acf/fields/post_object/query/name={$name} Applies to all fields of a specific name.
  • acf/fields/post_object/query/key={$key} Applies to all fields of a specific key.


This example demonstrates how to modify some of the Post Object query args.


add_filter('acf/fields/post_object/query', 'my_acf_fields_post_object_query', 10, 3);
function my_acf_fields_post_object_query( $args, $field, $post_id ) {

    // Show 40 posts per AJAX call.
    $args['posts_per_page'] = 40;

    // Restrict results to children of the current post only.
    $args['post_parent'] = $post_id;

    return $args;

We use cookies to offer you a better browsing experience, analyze site traffic and personalize content. Read about how we use cookies and how you can control them in our Cookie Policy. If you continue to use this site, you consent to our use of cookies.