WP Team List


WP Team List is a plugin that helps you to create a simple team site using your WordPress users with various display options. Either use a shortcode, a template tag or the built-in widget to display blog authors.

After creating similar functionality for a couple of clients, we decided to roll our knowledge into this simple plugin. It’s really straightforward to use:

First of all, the plugin adds a small checkbox to the user profile in WordPress to toggle its visibility in the team list. This means you can decide for every user whether he should show up in the team list or not.

You can then use one of these ways to display the list anywhere on your site.


Use the wp_team_list hook to directly display the users in your theme or plugin.

For example, you can show users of any role ordered by their name:

echo do_action( 'wp_team_list', array( 'role' => 'all', 'orderby' => 'name' ) );

Note: WP Team List supports many of the arguments WP_User_Query supports.


Use the [wp_team_list] shortcode to display a team list in your posts. Supported arguments:

  • role – Filter users by roles (comma-separated).
    Use all to show users with any role.
    Default: administrator
  • orderby
    Default: post_count
  • order – Either asc or desc.
    Default: desc.
  • include – Filter users with specific IDs (comma-separated).
  • has_published_posts – Filter users with published posts.
    Either a comma-separated list of post types or true to filter by all post types.


[wp_team_list role="author" orderby="last_name" order="desc"]

Pro tip: If you use the Shortcake WordPress plugin, you’ll get an inline preview of the shortcode right in the visual editor. You can also add the shortcode with the click of a button.


Want do display the team members in your sidebar? Use the built-in WordPress widget. You can set the role you want, the number of users to show and even link to a separate team page.


  • This is how your team list can look like with some additional CSS.
  • The plugin only provides limited styling. It's up to you to adjust it.
  • The configuration options of the built-in widget.


  1. Upload wp-team-list to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Use one of the supported methods (hook, shortcode, or widget) to display a team list.
  4. Optional: Set the visibility status of your users in their profiles.


Installation Instructions
  1. Upload wp-team-list to the /wp-content/plugins/ directory.
  2. Activate the plugin through the ‘Plugins’ menu in WordPress.
  3. Use one of the supported methods (hook, shortcode, or widget) to display a team list.
  4. Optional: Set the visibility status of your users in their profiles.
How do I contribute to WP Team List?

Easy! You can report bugs, with reproduction steps, or post patches on GitHub.

What kind of filters / hooks are available?
  • wp_team_list_user_role – Filter the user role displayed in the team list.
  • wp_team_list_query_args – Filter the WP_User_Query arguments.
  • wp_team_list_template – Change the team list template.
    Note: You can also put a rplus-wp-team-list.php file in your theme folder.
  • wp_team_list_avatar_size – Filter the default avatar size.



Brillante solución y muy simple!!!

He estado buscando un plugin que asocie directo el “equipo” (front) con el listado de usuarios de WP (back), sin tener que hacer un listado de equipo aparte. Y todos los plugins eran complicados y pesados o no cumplían. Este es una maravilla. Muchísimas gracias. Apenas pueda la traduzco al español.

Works great with your wp users

Searched days for a good member/team plugin. There are many free and paid plugins for this matter but almost all of them don’t use your wp users!

This plugin uses your wp users, is simple and also free. Awesome job 🙂

Read all 4 reviews

Contributors & Developers

“WP Team List” is open source software. The following people have contributed to this plugin.


“WP Team List” has been translated into 2 locales. Thank you to the translators for their contributions.

Translate “WP Team List” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.



  • Fix: Removed HTML output on profile page.
  • Fix: Removed type hint for shortcode attributes to avoid a PHP fatal error.
  • Fix: Correct author CSS classes.
  • Enhancement: Improved plugin description.
  • Enhancement: Translations moved to https://translate.wordpress.org/projects/wp-plugins/wp-team-list.
  • Enhancement: Added deprecation notice and removed shortcode UI for [rplus_team_list] shortcode in favour of the new [wp_team_list] shortcode.


  • Fix: Smaller corrections in the widget.
  • Enhancement: Improved documentation.
  • Enhancement: Simplified template loading.
  • Enhancement: Filterable user roles, making it easier to disable output.


  • Fix: A small error in the previous release.


  • Enhancement: Allows role ‘All’ in the widget to display users with any role.


  • Fix: Correct stylesheet URL.
  • Enhancement: Support multiple roles in the shortcode (comma-separated).
  • Enhancement: Enable only displaying users with specific IDs (? include` shortcode attribute).
  • Enhancement: Allow querying by users which have published posts (has_published_posts shortcode attribute).


  • Fix: Make ‘Order By’ string translatable.
  • Enhancement: Lots of improvements under the hood.
  • 100% compatible with WordPress 4.3.


  • Fix: Support ordering by last_name and first_name columns.


  • Successfully tested with WordPress 4.2
  • Fix: Properly translate the link title attributes


  • Fix: Correctly translate the user roles
  • New: Added German (Switzerland) translation (de_CH)


  • Fix: Updated textdomain to match the plugin slug


  • Initial Release