Title: Basic User Avatars
Author: Jared Atchison
Published: <strong>ژانویه 5, 2014</strong>
Last modified: نوامبر 15, 2024

---

Search plugins

![](https://ps.w.org/basic-user-avatars/assets/banner-772.250.png?rev=2560641)

![](https://ps.w.org/basic-user-avatars/assets/icon-256x256.png?rev=2560641)

# Basic User Avatars

 By [Jared Atchison](https://profiles.wordpress.org/jaredatch/)

[Download](https://downloads.wordpress.org/plugin/basic-user-avatars.1.0.9.zip)

 * [Details](https://azb.wordpress.org/plugins/basic-user-avatars/#description)
 * [Reviews](https://azb.wordpress.org/plugins/basic-user-avatars/#reviews)
 *  [Installation](https://azb.wordpress.org/plugins/basic-user-avatars/#installation)
 * [Development](https://azb.wordpress.org/plugins/basic-user-avatars/#developers)

 [Support](https://wordpress.org/support/plugin/basic-user-avatars/)

## Description

#### Add an avatar upload field on frontend pages and Edit Profile screen so users can add a custom profile picture.

Community and Membership sites on WordPress use this plugin as a lightweight solution
for custom user avatars. The plugin is compatible with bbPress, as well as many 
popular plugins with frontend user registration and profile management features.

Admins can upload a user’s avatar on the Edit User admin screen.

Basic User Avatars also supports front-end avatar management for sites that want
to keep users out of the dashboard. To use this feature, add the shortcode `[basic-
user-avatars]` to any page in your WordPress site. We recommended placing this shortcode
on another logged-in account type page, such as the WooCommerce My Account page,
the Membership Account page, or any other front-end profile edit form.

The Avatar Upload form is automatically added to the bbPress User Profile > Edit
frontend page.

If you do not want your users to be able to update their avatar, navigate to Settings
> Discussion and locate the “Local Avatar Permissions” setting. Check this box to
only allow users with file upload capabilities to upload local avatars (Author role
and above).

#### Seamlessly Migrate from WP User Avatar Plugin

Version 1.0.5 includes 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 the shortcode: `[basic-user-avatars]`.

## Screenshots

 * [[
 * Frontend avatar upload form without a custom profile picture.
 * [[
 * Avatar upload field on the Edit User screen in the WordPress admin.

## Installation

 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. Navigate to Users > Edit User to upload a custom avatar for your users.
 5. Add the `[basic-user-avatars]` shortcode to a page in your WordPress site to allow
    front-end avatar upload for your users.

bbPress support is added automatically if bbPress is activated.

Note: This plugin is a fork of Simple Local Avatars v1.3.1 by Jake Goldman and 10up.
Check out [Simple Local Avatars](https://wordpress.org/plugins/simple-local-avatars)
to compare their latest release to this plugin.

## FAQ

### 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.

## Reviews

![](https://secure.gravatar.com/avatar/01e1aa48f9cd5369c38a2e5f650c66075c26e24cbd193795b8a6dd92adefd8d5?
s=60&d=retro&r=g)

### 󠀁[Simply outstanding!](https://wordpress.org/support/topic/simply-outstanding-15/)󠁿

 [mikefury](https://profiles.wordpress.org/mikefury/) ژانویه 26, 2025

Great plugin. Thank you

![](https://secure.gravatar.com/avatar/5d0576657dc3a01c387f9537082e96ddbc31f54ad9efe99e8359e80b81a40448?
s=60&d=retro&r=g)

### 󠀁[Perfect!](https://wordpress.org/support/topic/perfect-10519/)󠁿

 [Thiago Pacheco](https://profiles.wordpress.org/pachecothiago/) سپتامبر 20, 2024
1 reply

Simple, objective and clean. Effective for users to upload their profile picture
on the frontend. Congratulations!

![](https://secure.gravatar.com/avatar/86f228f3f130d6b4400e31e3e9449289242291b581b374ebd8e725424889fa29?
s=60&d=retro&r=g)

### 󠀁[Excellent solution for local gravatar](https://wordpress.org/support/topic/excellent-solution-for-local-gravatar/)󠁿

 [Eder Ribeiro](https://profiles.wordpress.org/ribeiroeder/) مارس 20, 2024 1 reply

Simple, light, secure and easy to customize. Thanks!

![](https://secure.gravatar.com/avatar/30da3d21c0dfa12bbb8a4f8eda83d318c711ef628e439483b771196a51c04b16?
s=60&d=retro&r=g)

### 󠀁[Simple but powerful](https://wordpress.org/support/topic/simple-but-powerful-81/)󠁿

 [Soprano](https://profiles.wordpress.org/soprano/) آپریل 22, 2023 1 reply

Works really well to host local avatars, hoping they add a bit more options and 
integrations in the future

![](https://secure.gravatar.com/avatar/57c4a4069452d616d891cb6fa9dedee8831affa490804da39aa0d0e38f5dbd66?
s=60&d=retro&r=g)

### 󠀁[Works great](https://wordpress.org/support/topic/works-great-8617/)󠁿

 [jacksonbatnerd](https://profiles.wordpress.org/jacksonbatnerd/) ژانویه 9, 2023

Does what is says it does, perfect if you want a front-end option for users to upload
and editing their profile picture.

![](https://secure.gravatar.com/avatar/f8e8324a7a549752367e287be5d142fae36a754ede63eab6bbe3d7b15c5d3eec?
s=60&d=retro&r=g)

### 󠀁[Awesome Plugin](https://wordpress.org/support/topic/awesome-plugin-6676/)󠁿

 [arslank7](https://profiles.wordpress.org/arslank7/) نوامبر 24, 2022

Thank you so much… <3

 [ Read all 41 reviews ](https://wordpress.org/support/plugin/basic-user-avatars/reviews/)

## Contributors & Developers

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

Contributors

 *   [ Jared Atchison ](https://profiles.wordpress.org/jaredatch/)
 *   [ Jason Coleman ](https://profiles.wordpress.org/strangerstudios/)

“Basic User Avatars” has been translated into 4 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/basic-user-avatars/contributors)
for their contributions.

[Translate “Basic User Avatars” into your language.](https://translate.wordpress.org/projects/wp-plugins/basic-user-avatars)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/basic-user-avatars/),
check out the [SVN repository](https://plugins.svn.wordpress.org/basic-user-avatars/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/basic-user-avatars/)
by [RSS](https://plugins.trac.wordpress.org/log/basic-user-avatars/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.9 – 2024-11-13

 * ENHANCEMENT: Update tested up to WordPress 6.7.

#### 1.0.8 – 2024-01-23

 * ENHANCEMENT: Added filter ‘basic_user_avatars_default_size’ to allow changing
   the default size of the avatar. (Thanks @jarrydlong)
 * ENHANCEMENT: Improved functionality on how we load the text domain of the plugin
   for translations. (@ipokkel)
 * BUG FIX: Fixed a fatal issue when the option “Only allow users with file upload
   capabilities to upload local avatars (Authors and above)” wasn’t set on new installations.(
   @JarrydLong)

#### 1.0.7

 * ENHANCEMENT: Made “Delete Local Avatar” checkbox text clickable for frontend.(
   Thanks @pinguluk )
 * BUG FIX: Fixed an issue where Avatars weren’t saving correctly when changing 
   an existing uploaded avatar. (Thanks @jarrydlong)
 * BUG FIX: Fixed an issue where Avatars weren’t saving on the frontend in certain
   cases. (Thanks @amatzin)
 * BUG FIX: Fixed deprecation warnings when getting the Avatar for PHP 8+ (Thanks
   @ZebulanStanphill)

#### 1.0.6

 * ENHANCEMENT: Added translation for German locale. Thanks @olpo24
 * ENHANCEMENT: Added translation for Italian locale. Thanks @domegang
 * ENHANCEMENT: Now filtering the get_avatar_data WordPress hook to allow more flexibility
   in customizing avatars via other filters.
 * ENHANCEMENT: Added filter `basic_user_avatar_data` to allow filtering on the 
   avatar data that we are overriding.
 * BUG FIX: Fixed issue with saving the Discussion setting limiting avatar upload
   to users with file upload capabilities.
 * BUG FIX: Fixed an issue when user display names were interfering and causing 
   404 errors. Thanks @semanio.

#### 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

#### 1.0.0

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

## Community plugin

This plugin is developed and supported by a community. [Contribute to this plugin](https://github.com/strangerstudios/basic-user-avatars/)

## Meta

 *  Version **1.0.9**
 *  Last updated **1 ایل ago**
 *  Active installations **20٫000+**
 *  WordPress version ** 5.2 or higher **
 *  Tested up to **6.7.5**
 *  Languages
 * [Chinese (Taiwan)](https://tw.wordpress.org/plugins/basic-user-avatars/), [Dutch](https://nl.wordpress.org/plugins/basic-user-avatars/),
   [English (US)](https://wordpress.org/plugins/basic-user-avatars/), [Greek](https://el.wordpress.org/plugins/basic-user-avatars/),
   و [Ukrainian](https://uk.wordpress.org/plugins/basic-user-avatars/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/basic-user-avatars)
 * Tags
 * [avatar](https://azb.wordpress.org/plugins/tags/avatar/)[gravatar](https://azb.wordpress.org/plugins/tags/gravatar/)
   [profile](https://azb.wordpress.org/plugins/tags/profile/)[user profile](https://azb.wordpress.org/plugins/tags/user-profile/)
   [users](https://azb.wordpress.org/plugins/tags/users/)
 *  [Advanced View](https://azb.wordpress.org/plugins/basic-user-avatars/advanced/)

## Ratings

 4.7 out of 5 stars.

 *  [  37 5-star reviews     ](https://wordpress.org/support/plugin/basic-user-avatars/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/basic-user-avatars/reviews/?filter=4)
 *  [  2 3-star reviews     ](https://wordpress.org/support/plugin/basic-user-avatars/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/basic-user-avatars/reviews/?filter=2)
 *  [  2 1-star reviews     ](https://wordpress.org/support/plugin/basic-user-avatars/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/basic-user-avatars/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/basic-user-avatars/reviews/)

## Contributors

 *   [ Jared Atchison ](https://profiles.wordpress.org/jaredatch/)
 *   [ Jason Coleman ](https://profiles.wordpress.org/strangerstudios/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/basic-user-avatars/)