WordPress uses Gravatar for profile pictures by default. A user avatar only appears when that user has a Gravatar account under the same email address they use on your site. On many business sites, that leaves authors with a gray silhouette.
Rathly Profile Avatars is a free WordPress custom avatar plugin we built at Rathly. Each user picks a custom user avatar from the WordPress Media Library, and it replaces their Gravatar across the site. Users set it without an extra account or code.
Why replace Gravatar with your own avatars
Gravatar links an avatar to an email address on its own service. That works for bloggers who comment across many sites. It works less well for a law firm, a clinic or an agency, where every author needs a consistent, approved headshot. Healthcare web design needs one for each clinician who reviews medical content.
A custom avatar plugin keeps each user avatar in your own Media Library. Your team controls the image, its crop and when to change it, and the picture loads from your site instead of a third-party service.
Features
We read through version 1.0.0 of the code to confirm each one.
- Media Library images. Users choose an existing image or upload a new one in the standard media window.
- Site-wide display. The avatar replaces Gravatar wherever your theme calls the WordPress avatar functions.
- Responsive images. WordPress serves a sized copy of the avatar, with srcset for sharp display on any screen.
- Gravatar fallback. Users without a custom avatar keep using their Gravatar or the default image.
- Comment matching. Comments from a registered user's email address show that user's custom avatar.
- Clean uninstall. Deleting the plugin removes the avatar setting from every user profile.
The plugin hooks the get_avatar and get_avatar_url filters, the same functions most themes use for author boxes, comments and the admin bar.
Who can set a custom avatar
Each user sets their own avatar on the user profile screen. Choosing an avatar opens the Media Library, so it needs the upload files capability. There is no settings page, and the only option lives on each user profile.
By default, WordPress allows the Administrator, Editor and Author roles to upload media. Contributors and Subscribers can't, so an administrator should add images for those users to the Media Library first, or raise their role.
How to add a custom avatar in WordPress
- Go to Users, then Profile, in the WordPress dashboard.
- Find the Profile Picture row and click Upload New Picture.
- Choose or upload a square image, then click Use this image.
- Click Update Profile at the bottom of the screen to save the avatar.
To go back to Gravatar, click Remove Picture and update the profile again. The image itself stays in the Media Library.
Image tips for author photos
WordPress requests avatars at 96 pixels by default, and many themes show them larger in author boxes. Upload a square headshot at least a few hundred pixels wide, so it stays sharp on high-density phone screens. Real author photos also help readers trust a page, so good SEO services add them to service pages as well.
Crop every team photo the same way, with similar lighting and background, so author pages look consistent. Your theme sets the alt text for avatars, so check that author boxes also show the person's name.
Gravatar compared with Rathly Profile Avatars
| Question | Gravatar | Rathly Profile Avatars |
|---|---|---|
| Where the avatar lives | Gravatar's servers | Your Media Library |
| What the user needs | A Gravatar account with the same email | A WordPress login that can upload media |
| Who controls the image | Each person, on Gravatar | Your site's users and administrators |
| Visitor comments | Shows each commenter's Gravatar | Unchanged, still Gravatar |
Avatars must be on for any of this to show. Under Settings, then Discussion, tick Show Avatars and save.
Compatibility and uninstall
The plugin works with any theme or plugin that displays avatars through the standard WordPress functions. Some page builders and profile plugins use their own image fields instead, and those won't show the custom photo.
If you deactivate the plugin, the site returns to Gravatar and your images stay in the Media Library. If you delete it, it also clears the saved avatar choice from every profile.
Install Rathly Profile Avatars
It requires WordPress 6.0 or later and PHP 7.2 or later. Its WordPress.org listing reports testing up to 7.0.7, and it is free and GPL licensed.
- In the dashboard, search the plugin directory for Rathly Profile Avatars.
- Install it and activate it on the Plugins screen.
- Open your profile and add a custom avatar.
Find the source on GitHub, or ask in the WordPress.org support forum for the plugin. For full author pages with bios and credentials, our WordPress development team can build the layout around it.




