Title: wp_list_users_args
Published: November 2, 2022
Last modified: February 24, 2026

---

# apply_filters( ‘wp_list_users_args’, array $query_args, array $parsed_args )

## In this article

 * [Parameters](https://developer.wordpress.org/reference/hooks/wp_list_users_args/?output_format=md#parameters)
 * [Source](https://developer.wordpress.org/reference/hooks/wp_list_users_args/?output_format=md#source)
 * [Related](https://developer.wordpress.org/reference/hooks/wp_list_users_args/?output_format=md#related)
 * [Changelog](https://developer.wordpress.org/reference/hooks/wp_list_users_args/?output_format=md#changelog)

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

Filters the query arguments for the list of all users of the site.

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

 `$query_args`array

The query arguments for [get_users()](https://developer.wordpress.org/reference/functions/get_users/).

More Arguments from get_users( … $args )

Arguments to retrieve users. See [WP_User_Query::prepare_query()](https://developer.wordpress.org/reference/classes/wp_user_query/prepare_query/)
for more information on accepted arguments.

`$parsed_args`array

The arguments passed to [wp_list_users()](https://developer.wordpress.org/reference/functions/wp_list_users/)
combined with the defaults.

More Arguments from wp_list_users( … $args )

Array or string of default arguments.

 * `orderby` string
 * How to sort the users. Accepts `'nicename'`, `'email'`, `'url'`, `'registered'`,`'
   user_nicename'`, `'user_email'`, `'user_url'`, `'user_registered'`, `'name'`,`'
   display_name'`, `'post_count'`, `'ID'`, `'meta_value'`, `'user_login'`. Default`'
   name'`.
 * `order` string
 * Sorting direction for $orderby. Accepts `'ASC'`, `'DESC'`. Default `'ASC'`.
 * `number` int
 * Maximum users to return or display. Default empty (all users).
 * `exclude_admin` bool
 * Whether to exclude the `'admin'` account, if it exists. Default false.
 * `show_fullname` bool
 * Whether to show the user’s full name. Default false.
 * `feed` string
 * If not empty, show a link to the user’s feed and use this text as the alt parameter
   of the link.
 * `feed_image` string
 * If not empty, show a link to the user’s feed and use this image URL as clickable
   anchor.
 * `feed_type` string
 * The feed type to link to, such as `'rss2'`. Defaults to default feed type.
 * `echo` bool
 * Whether to output the result or instead return it. Default true.
 * `style` string
 * If `'list'`, each user is wrapped in an `<li>` element, otherwise the users will
   be separated by commas.
 * `html` bool
 * Whether to list the items in HTML form or plaintext. Default true.
 * `exclude` string
 * An array, comma-, or space-separated list of user IDs to exclude.
 * `include` string
 * An array, comma-, or space-separated list of user IDs to include.

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

    ```php
    $query_args = apply_filters( 'wp_list_users_args', $query_args, $parsed_args );
    ```

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

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

| Used by | Description | 
| [wp_list_users()](https://developer.wordpress.org/reference/functions/wp_list_users/)`wp-includes/user.php` |

Lists all the users of the site, with several options available.

  |

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

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

## User Contributed Notes

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