wp_list_authors( string|array $args = '' )

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

25 related functions found for: wp_list_authors

Top ↑

Related terms found for this post

wp-parser-related-wordsauthor, author-template-php, authors, list, user, wp-includes, wp-list
wp-parser-packageTemplate, WordPress

Top ↑

Terms Used Terms Used

Terms used in the related posts query

  • author
  • author-template-php
  • authors
  • list
  • Template
  • user
  • wp-includes
  • wp-includes/author-template.php
  • wp-list
  • template

Top ↑

Description Description

Top ↑

Parameters Parameters


(string|array) (Optional) 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 false.
  • '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, 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 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'
    (array|string) Array or comma/space-separated list of author IDs to exclude.
  • 'include'
    (array|string) Array or comma/space-separated list of author IDs to include.

Default value: ''

Top ↑

Return Return

(string|void) The output, if echo is set to false.

Top ↑

Source Source

File: wp-includes/author-template.php


Top ↑

Changelog Changelog

Version Description
1.2.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.