Title: wp_list_authors_args
Published: November 2, 2022
Last modified: May 20, 2026

---

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

## In this article

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

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

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

## 󠀁[Parameters](https://developer.wordpress.org/reference/hooks/wp_list_authors_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_authors()](https://developer.wordpress.org/reference/functions/wp_list_authors/)
combined with the defaults.

More Arguments from wp_list_authors( … $args )

Array or string of default arguments.

 * `orderby` string
 * How to sort the authors. 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 authors to return or display. Default empty (all authors).
 * `optioncount` bool
 * Show the count in parenthesis next to the author’s name. Default false.
 * `exclude_admin` bool
 * Whether to exclude the `'admin'` account, if it exists. Default true.
 * `show_fullname` bool
 * Whether to show the author’s full name. Default false.
 * `hide_empty` bool
 * Whether to hide any authors with no posts. Default true.
 * `feed` string
 * If not empty, show a link to the author’s feed and use this text as the alt parameter
   of the link.
 * `feed_image` string
 * If not empty, show a link to the author’s feed and use this image URL as clickable
   anchor.
 * `feed_type` string
 * The feed type to link to. Possible values include `'rss2'`, `'atom'`.
    Default
   is the value of [get_default_feed()](https://developer.wordpress.org/reference/functions/get_default_feed/).
 * `echo` bool
 * Whether to output the result or instead return it. Default true.
 * `style` string
 * If `'list'`, each author is wrapped in an `<li>` element, otherwise the authors
   will be separated by commas.
 * `html` bool
 * Whether to list the items in HTML form or plaintext. Default true.
 * `exclude` int[]|string
 * Array or comma/space-separated list of author IDs to exclude.
 * `include` int[]|string
 * Array or comma/space-separated list of author IDs to include.

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

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

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

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

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

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

  |

## 󠀁[Changelog](https://developer.wordpress.org/reference/hooks/wp_list_authors_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_authors_args%2F)
before being able to contribute a note or feedback.