Basic User Avatars


Adds an avatar upload field to user profiles inside the WordPress dashboard.

Provides a plugin for front-end avatar management for sites that what to keep users out of the dashboard. Shortcode is [basic-user-avatars].

Version 1.0.5 added a feature to automatically convert avatars formerly loaded through the WP User Avatar plugin. This means that you can disable WP User Avatar, activate Basic User Avatars, and have a seamless transition for existing avatars in your site. Be sure to update any avatar upload form that used the [avatar_upload] shortcode to use our shortcode: [basic-user-avatars].

Automatically adds avatar support to bbPress (2.3+) user profiles if bbPress is activated.

This plugin is on GitHub! Pull requests are welcome. If possible please report issues through Github.

Note: This plugin is a fork of Simple Local Avatars v1.3.1 by Jake Goldman (10up). If you want snazzy ajax and some other nifty features, check out Simple Local Avatars 2.x.


  • Option on the user profile edit page.
  • Option on the front-end via the shortcode.
  • Option on the bbPress user profile edit page.


  1. Upload basic-user-avatars to your /wp-content/plugins/ directory or download through the Plugins page
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. If you only want users with file upload capabilities to upload avatars, check the applicable option under Settings > Discussion
  4. Start uploading avatars by editing user profiles!

bbPress support is added automatically if bbPress is activated.

Shortcode for front-end support is [basic-user-avatars].


I’m still having problems

While this plugin has been tested with common server setups, some enviroments could cause an issue.

If you are having a problem deactivate all plugins other than this one and then switch your theme to TwentyTweleve (or similar). If things work, then the issue is with a 3rd party theme or plugin.

If things are still not functioning properly then proceed to reporting an issue. The ideal method is via GitHub issues.


སྤྱི་ཟླ་ལྔ་པ། 25, 2021
Now that Wp User Avatar has been hijacked by ProfilePress, this plugin reproduces all its functionality in a simple and fast way... Works great!
སྤྱི་ཟླ་གསུམ་པ། 7, 2021
I really wanted to give this plugin 5 stars but I simply can't. While the name of the plugin has the word "Basic" in it, is a little too basic. Even a basic avatar plugin should have the ability to limit for upload size or image size resolution. This plugin will allow anyone to upload MASSIVE profile pictures that can slow down your page load times. Limiting a file size should be very easy to code for plugin developers and easy to add to the plugin. Add this feature and you get a 5 star for a basic plugin but without this, 3 star at best.
Read all 34 reviews

Contributors & Developers

“Basic User Avatars” is open source software. The following people have contributed to this plugin.


Translate “Basic User Avatars” into your language.

Interested in development?

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


1.0.5 – 2021-05-19

  • ENHANCEMENT: Now pulling avatar from WP User Avatar if we don’t have one yet

1.0.4 – 2020-01-12

  • BUG FIX: Fixed typos on readme.txt – Thanks @fred-pedro
  • ENHANCEMENT: Added translation for Spanish – Thanks @ricardpriet
  • ENHANCEMENT: Added translation for Brazilian Portuguese – Thanks @allysonsouza
  • ENHANCEMENT: Added translation for Catalan – Thanks @alvaromartinezmajado
  • ENHANCEMENT: Added proper SSL support – Thanks @zachwills
  • ENHANCEMENT: Escaped strings.

1.0.3 – 2015-08-05

  • ENHANCEMENT: Added Swedish and Finnish translations – Thanks @dmaester

1.0.2 – 2015-04-17

  • ENHANCEMENT: Added POT file for translation

1.0.1 – 2015-03-17

  • BUG FIX: Updated textdomain for better support
  • ENHANCEMENT: Added plugin to GitHub for better collaboration


  • Initial launch, should be considered beta. Use with caution.