What is Simple User Avatar plugin?
Simple User Avatar is a lightweight WordPress plugin that adds a single feature: an avatar upload field on the WordPress user profile screen. Users can select an image from the media library or upload a new one directly. The selected image becomes their WordPress avatar, displayed in comments, author bios, and anywhere else WordPress outputs the user avatar.
The plugin is intentionally minimal. It does not add widgets, shortcodes, bulk management tools, or extensive settings. It solves one problem — allowing locally uploaded avatars instead of Gravatar — with the smallest possible codebase.
For sites that need avatar functionality without extra features, Simple User Avatar is a clean choice. For sites that need more control over avatar management, restrictions by role, or additional avatar display options, Simple Local Avatars or WP User Avatar offer more configuration options.
Need Help With Simple User Avatar Setup, Troubleshooting, or Customization?
Need help with Simple User Avatar? Whether you are dealing with errors, broken functionality, styling problems, plugin conflicts, or advanced customization, we can help you fix the issue and get the plugin working properly on your WordPress site.
Get Simple User Avatar Expert HelpKey Features
- Avatar upload field on WordPress user profile
- Images stored in WordPress media library
- Replaces Gravatar for users who upload a local avatar
- Hooks into standard get_avatar WordPress function
- No additional settings or configuration required
Pros & Cons
Pros
- Minimal codebase with no unnecessary features
- Works immediately after activation with no setup
- Free and lightweight
Cons
- No settings for default avatar, role restrictions, or Gravatar disable
- No bulk management for multiple users
Free vs Premium
Simple User Avatar is completely free with no premium version.
Common Problems & Fixes
Avatar uploaded through Simple User Avatar is not showing on the front end.
Verify the avatar was correctly saved by going back to the user profile after uploading and confirming the image is still shown. Clear all caches. If the avatar still does not show, check whether your theme uses a custom avatar function rather than the standard WordPress get_avatar — Simple User Avatar only intercepts calls through the standard function. Themes with custom avatar display may need a small code adjustment to use get_avatar.
Gravatar images are still showing for some users even with Simple User Avatar active.
Simple User Avatar replaces Gravatar only for users who have uploaded a local avatar. Users without a local avatar still fall back to Gravatar. If you want to prevent all Gravatar requests, you need a plugin that offers a disable Gravatar option such as Simple Local Avatars. Simple User Avatar does not include a Gravatar disable setting.
The avatar upload field is missing from the user profile screen.
Verify Simple User Avatar is active in the Plugins screen. If active, check whether another user profile plugin is replacing the standard WordPress profile screen — some membership and user management plugins use a fully custom profile screen that removes sections added by other plugins. Also confirm you are looking at the standard WordPress user profile at Users, then your Profile, not a front-end profile page added by another plugin.
Customization & Developer Notes
Can I use Simple User Avatar to set avatars for all users at once as an admin?
Simple User Avatar does not include bulk avatar management. Each avatar must be set individually on each user profile. If you need to set avatars for many users at once, WP User Avatar or a user management plugin with bulk profile editing is more appropriate. For small teams where avatars are set once and rarely changed, the per-profile approach of Simple User Avatar is not a significant burden.
How do I completely disable Gravatar and use only local avatars with this plugin?
Simple User Avatar does not include a Gravatar disable option. To disable Gravatar entirely, add a filter to your child theme functions.php that returns an empty string or a local default image when no local avatar is set, overriding the Gravatar fallback. Alternatively, switch to Simple Local Avatars which includes a dedicated option to disable all Gravatar lookups and replace them with a default local image.
Frequently Asked Questions
What is the difference between Simple User Avatar and Simple Local Avatars?
Simple User Avatar is a minimal plugin that does one thing: adds an avatar upload field to user profiles. Simple Local Avatars is developed by 10up and includes additional features such as role-based upload restrictions, a setting to disable all Gravatar requests, and a custom default avatar option. If you need only the basic upload functionality, Simple User Avatar is sufficient. If you need more control over Gravatar fallback and access restrictions, Simple Local Avatars is more complete.
Does Simple User Avatar work with WordPress Multisite?
Simple User Avatar can be activated per site or network-activated on Multisite. When network-activated, the avatar upload field appears on user profiles across the network. Avatars are stored per-site in the respective site media library. Users on multiple sites in a network would need to upload an avatar separately on each site if the plugin is site-activated rather than network-activated.
Can front-end users upload their own avatars, or is this admin-only?
Simple User Avatar adds the upload field to the WordPress admin user profile screen. Front-end profile pages require a separate user profile plugin that outputs a profile editing form on the front end. If you use a plugin like ProfilePress or Ultimate Member for front-end profiles, check whether those plugins have their own avatar upload functionality built in, which they typically do independently of Simple User Avatar.
Will Simple User Avatar avatar images be lost if I switch to a different avatar plugin?
The uploaded images themselves remain in the WordPress media library regardless of which plugin is active. The user meta entry that links a user to their avatar image is stored in the database. If you switch to another avatar plugin that uses a different meta key to store the avatar reference, the new plugin will not automatically recognise the images set by Simple User Avatar. You may need to re-assign avatars after switching plugins.