What is WP User Avatar plugin?
WP User Avatar is a WordPress plugin that allows site users to upload a profile photo directly to the WordPress media library, replacing the default Gravatar system. The plugin integrates with the WordPress user profile screen and adds an avatar upload field where users can select or upload an image from the media library.
Like Simple Local Avatars, WP User Avatar eliminates the privacy concern of email addresses being sent to Gravatar servers and removes the external dependency on the Gravatar CDN. Avatars are stored locally and served from the same origin as the rest of the site.
WP User Avatar also adds a widget that displays the current user’s avatar, and a shortcode for embedding avatars in content. It hooks into the standard WordPress get_avatar function, meaning local avatars appear everywhere the standard avatar function is called — comments, author bios, BuddyPress profiles, and WooCommerce account pages.
Need Help With WP User Avatar Setup, Troubleshooting, or Customization?
Need help with WP 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 WP User Avatar Expert HelpKey Features
- Upload profile avatars from WordPress media library
- Replaces Gravatar with locally hosted photos
- Hooks into standard WordPress get_avatar function
- Avatar widget and shortcode
- Works with comments, author bios, BuddyPress, and WooCommerce
Pros & Cons
Pros
- Eliminates Gravatar external requests for privacy and performance
- Avatars always served from your own server
- Works everywhere get_avatar is called without extra configuration
Cons
- Adds to media library storage for sites with many users
- Users without local avatars may still show Gravatar unless fully disabled
Free vs Premium
WP User Avatar is completely free with no premium version.
Common Problems & Fixes
Uploaded avatars are not showing and Gravatar images are still appearing.
Go to Settings, then Discussion, and find the avatar settings. Ensure WP User Avatar is set as the active avatar source. If users still see Gravatar, it means their local avatar was not set correctly — go to that user profile and verify the avatar upload field shows the correct image. Also clear all caches. If caching plugins are serving a cached version of a page before the local avatar was set, the old Gravatar may continue to display until the cache is cleared.
The avatar upload field is not visible on the user profile screen.
WP User Avatar adds its upload field to the user profile screen. If the field is not visible, verify the plugin is active. On multisite installations, the plugin may need to be network activated for the avatar field to appear on all sites. Also check whether a user management plugin or custom profile plugin is overriding the user profile screen in a way that removes sections added by other plugins.
Avatars are uploaded but appearing at low quality or wrong dimensions.
WordPress generates multiple thumbnail sizes for uploaded images. Avatar display pulls one of the registered image sizes. If the avatar appears blurry or incorrectly sized, the source image may be smaller than the requested display size. Upload a source image that is at least 300×300 pixels for avatars. If thumbnails were generated at the wrong size, use the Regenerate Thumbnails plugin to regenerate image sizes after updating size settings.
Customization & Developer Notes
How do I set a default avatar for users who have not uploaded one?
Go to Settings, then Discussion, and look for the Default Avatar option. WP User Avatar adds an option to set a custom default avatar image. Upload your preferred default image through the media library, then select it as the default avatar. This image will display for any user who has not uploaded a personal avatar, giving a consistent branded appearance rather than the generic mystery person silhouette.
Can I restrict avatar uploads to administrators only?
WP User Avatar has a setting to control who can upload avatars. In the plugin settings, look for the option to restrict avatar uploads by user role. Setting this to administrators only means only admin accounts can set avatars — other users will use the default avatar or their Gravatar. This is useful for sites where only staff authors have profile photos and regular members do not.
Frequently Asked Questions
What is the difference between WP User Avatar and Simple Local Avatars?
Both plugins do essentially the same thing — replace Gravatar with locally uploaded avatars. Simple Local Avatars is developed by 10up and is slightly more lightweight. WP User Avatar includes a few additional features like the avatar widget and shortcode. Either plugin works well for the core use case. If you are choosing between them, Simple Local Avatars has a slightly stronger maintenance track record. If you already have WP User Avatar installed and it is working, there is no need to switch.
Does WP User Avatar work with BuddyPress?
BuddyPress has its own avatar system that allows members to upload profile photos through BuddyPress member settings. WP User Avatar and BuddyPress can coexist, but BuddyPress avatars and WP User Avatar avatars are separate systems. A BuddyPress avatar does not automatically become the WordPress user avatar and vice versa. For sites using BuddyPress, manage avatars through BuddyPress member settings rather than through WP User Avatar to avoid confusion.
Will removing WP User Avatar delete all uploaded profile photos?
Deactivating WP User Avatar does not delete uploaded images — they remain in the WordPress media library. The user meta entries that link profiles to their avatar images also remain in the database. However, without the plugin active, WordPress reverts to the Gravatar system and the local avatar images are no longer used. If you reinstall WP User Avatar later, the existing avatar links should be restored.
Can I use WP User Avatar on a WooCommerce site for customer profile photos?
Yes. WP User Avatar works for all WordPress users including WooCommerce customers with accounts. Customer avatars appear on WooCommerce account pages and in the WordPress admin user list. WooCommerce does not display customer avatars prominently in the shopping experience by default, but they are available if your theme or a custom template references the standard WordPress avatar function for registered users.