On This Page
On This Page
Local User Avatar
Overview
Choose a WordPress profile picture directly from your site’s Media Library instead of managing that user’s image through Gravatar. Local User Avatar adds a preview and image-selection controls to Profile and Edit User screens, letting eligible users or an administrator choose, replace, or remove an avatar.
The selected image is stored as a Media Library attachment reference and used through supported WordPress avatar output. Local choices take priority over WP PowerSuite’s initials and Google-photo integrations, while users without a local image retain the site’s other avatar behavior. Local User Avatar is a Free module configured per user rather than through a separate module settings page.

- Agencies setting up client and staff profile images inside WordPress
- Editorial teams that want locally managed author portraits
- Sites combining local images with Google photos or initials avatars
- Administrators who want per-user avatar control without changing global defaults
Features
Media Library Profile Images
Profile-Based Controls
Administrator Management
Permission-Aware Selection
Local Image Priority
Automatic Reference Cleanup
Normal WordPress Avatar Output
Use Cases
- Agency Client ProfilesChoose the client's preferred local profile image during website handover without requiring a Gravatar update for that account.
- Editorial HeadshotsManage distinct author images through WordPress profiles and supported avatar output.
- Staff Image UpdatesReplace an individual team member's avatar without changing the default avatar for other users.
- Mixed Avatar StrategiesUse local portraits for selected accounts while leaving Google photos, initials, or other configured defaults available elsewhere.
Frequently Asked Questions
Where do I set a local avatar?
On the WordPress Profile or Edit User screen. The module does not have a separate settings page.
Where does the avatar image come from?
A valid image attachment in the site’s Media Library. The user’s avatar setting stores that attachment ID.
Can a user select any image in the Media Library?
No. A non-admin editing their own profile must own the selected attachment and have permission to edit it.
Can administrators manage another user's avatar?
Yes, through the supported Edit User profile workflow, with the applicable account and attachment permissions.
Does it replace Gravatar everywhere?
No. It overrides supported avatar output when a valid local image is assigned. Users without one retain the site’s other avatar behavior.
Will it override a Google profile photo?
A valid local attachment takes priority over the Google Sign In avatar integration.
What happens when Alphabet Avatars is enabled too?
Alphabet Avatars skips users who already have a valid local avatar rather than replacing their image with initials.
Can I paste a remote avatar URL?
No. This module uses Media Library attachments. It does not consume the remote photo URL stored by GitHub Sign In.
Does it add an avatar uploader to WooCommerce My Account?
No. A frontend upload form and WooCommerce My Account profile-image control are outside this module’s scope.
What happens if the selected attachment is deleted?
Matching user-avatar assignments are removed, allowing the site’s other configured avatar behavior to apply.
Will every custom theme image change automatically?
Only output using the supported WordPress avatar functions is covered. A separately coded profile-image system may not use those functions.
Is Local User Avatar free?
Yes. Local User Avatar is a Free module included with WP PowerSuite.


