Title: WP_User_Query::fill_query_vars
Published: December 9, 2015
Last modified: April 28, 2025

---

# WP_User_Query::fill_query_vars( string|array $args ): array

## In this article

 * [Parameters](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#changelog)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#wp--skip-link--target)

Fills in missing query variables with default values.

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#parameters)󠁿

 `$args`string|arrayrequired

Query vars, as passed to `WP_User_Query`.

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#return)󠁿

 array Complete query variables with undefined ones filled in with defaults.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#source)󠁿

    ```php
    public static function fill_query_vars( $args ) {
    	$defaults = array(
    		'blog_id'             => get_current_blog_id(),
    		'role'                => '',
    		'role__in'            => array(),
    		'role__not_in'        => array(),
    		'capability'          => '',
    		'capability__in'      => array(),
    		'capability__not_in'  => array(),
    		'meta_key'            => '',
    		'meta_value'          => '',
    		'meta_compare'        => '',
    		'include'             => array(),
    		'exclude'             => array(),
    		'search'              => '',
    		'search_columns'      => array(),
    		'orderby'             => 'login',
    		'order'               => 'ASC',
    		'offset'              => '',
    		'number'              => '',
    		'paged'               => 1,
    		'count_total'         => true,
    		'fields'              => 'all',
    		'who'                 => '',
    		'has_published_posts' => null,
    		'nicename'            => '',
    		'nicename__in'        => array(),
    		'nicename__not_in'    => array(),
    		'login'               => '',
    		'login__in'           => array(),
    		'login__not_in'       => array(),
    		'cache_results'       => true,
    	);

    	return wp_parse_args( $args, $defaults );
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-user-query.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/6.9.4/src/wp-includes/class-wp-user-query.php#L92)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/6.9.4/src/wp-includes/class-wp-user-query.php#L92-L127)

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#related)󠁿

| Uses | Description | 
| [get_current_blog_id()](https://developer.wordpress.org/reference/functions/get_current_blog_id/)`wp-includes/load.php` |

Retrieves the current site ID.

  | 
| [wp_parse_args()](https://developer.wordpress.org/reference/functions/wp_parse_args/)`wp-includes/functions.php` |

Merges user defined arguments into defaults array.

  |

| Used by | Description | 
| [WP_User_Query::prepare_query()](https://developer.wordpress.org/reference/classes/wp_user_query/prepare_query/)`wp-includes/class-wp-user-query.php` |

Prepares the query variables.

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/classes/wp_user_query/fill_query_vars/?output_format=md#changelog)󠁿

| Version | Description | 
| [4.4.0](https://developer.wordpress.org/reference/since/4.4.0/) | Introduced. |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_user_query%2Ffill_query_vars%2F)
before being able to contribute a note or feedback.