Plugin Directory

Author Avatars List

Display lists of user avatars using widgets or shortcodes.

Shortcode, huh?

A shortcode is a tag like [authoravatars] which you can insert into a page or post to display a list of users on that post/page. You can read more about shortcodes in general in the wordpress codex, for example here or here.

How do I use the author avatar shortcode?

As of version 0.6 the plugin comes with a tinymce plugin which makes it very easy to insert shortcode(s).

If you'd like to do it manually it's still simple: just add [authoravatars] into your post and hit save! There's a large number of parameters available.

The plugin comes with two shortcodes: [authoravatars] for lists of avatars and [show_avatar] for single avatars.

I can't get my widget to show users from multiple blogs!

Make sure you have enabled the "blog filter" in Site Admin / Author Avatars for the blog on which you are trying to use this feature on. By default this is only enabled for the root blog (blog id = 1).

And you are running WordPress MU (or respectively WordPress 3 in multi-site mode), right?

Can I upload custom pictures for users?

No, the Author Avatars List plugin only provides ways of displaying user avatars.

The plugin uses the WordPress Core Template function get_avatar() to retrieve the actual avatar images. In order to display custom images you need to look for plugins which use/override WordPress' avatar features and provide respective upload features...

Have a look at the User Photo Plugin (turn on option "Override Avatar with User Photo") or the Add Local Avatar Plugin.

I get a "404 Page not found" error when I click on the avatar of a user!

This can happens when you've choosen to link users to their "author page" and the user has not written any posts on a blog. There are two things that you should do in this situation:

  1. To prevent the 404 page from showing up install the Show authors without posts Plugin. This forces WordPress to always show the user page if the user exists.

  2. If not already there add a custom user/author template to your theme. Otherwise if a user has no posts their user page is going to be quite empty by default... You can find a tutorial on Author Templates as well as a Sample Template File in the WordPress Codex.

Can I use html in user biographies?

WordPress Core unfortunately strips all html from the user biography field when entered. Install the plugin Weasel's HTML Bios if you want to use html...

How can I change the styling of the avatar lists?

The styling of the widget is controlled by the styles defined in css/widgets.css, avatars on posts/pages (using the shortcode) are styled by code in css/shortcode.css.

You can override the styles in that file by copying a style block to your theme's style.css and adjusting respectively. For example add the following to remove the padding from avatars displayed in a widget:

html .widget_author_avatars .author-list .user {
  padding: 0;

demo edit

Requires: 3.0 or higher
Compatible up to: 4.4.4
Last Updated: 4 months ago
Active Installs: 10,000+


4.8 out of 5 stars


0 of 1 support threads in the last two months have been marked resolved.

Got something to say? Need help?


Not enough data

0 people say it works.
0 people say it's broken.

100,1,1 83,6,5 100,1,1
75,4,3 100,1,1
100,3,3 100,4,4
100,6,6 100,1,1
0,1,0 100,1,1 0,1,0
100,2,2 100,2,2
100,1,1 0,1,0 67,3,2 50,2,1
100,1,1 100,1,1
0,1,0 0,1,0 100,1,1 100,1,1 100,1,1