How to change a WordPress user profile picture

WordPress commonly displays a user profile picture through Gravatar, an avatar service that matches an image to the email address saved in the WordPress user account. A self-hosted site can also use a local-avatar plugin when administrators want profile images stored and managed in the WordPress Media Library.

Method 1: change your picture with Gravatar

The standard WordPress user profile screen displays the Gravatar associated with the account email. The critical detail is the email match: the address connected to the image must be the same address saved under your WordPress user profile.

1. Confirm the email used by WordPress. In your dashboard, open Users > Profile or Users > Your Profile and note the email address saved for the account.
2. Open your Gravatar profile. Visit Gravatar or your WordPress.com account profile and sign in with the account that manages the email address.
3. Add and verify the matching email. When the WordPress email is not already connected to the Gravatar account, add it and complete any verification request.
4. Upload or choose the avatar. Select a clear, square image, adjust the crop, and save it to the email address used by the WordPress account.
5. Check the WordPress site again. Reload the profile page and a public location where the avatar appears, such as an author box or comment. Clear site and browser caches if the old image remains.

Choose a profile image that works at small sizes

Avatars are often displayed as small circles or squares. Use an image with a centered subject, uncomplicated background, and enough contrast to remain recognizable when reduced. Avoid placing important details close to the edges because themes and plugins may crop the image differently.

• Start with a square image so the crop behaves predictably.
• Use a recent photo, logo, or illustration that clearly identifies the person or brand.
• Check the result against both light and dark page backgrounds.
• Do not upload confidential information or an image you do not have permission to use.

Method 2: upload a local WordPress avatar

Self-hosted WordPress does not normally provide a general local profile-picture uploader in the standard user screen. A plugin can add this capability and store the image with the site's other uploaded media.

The original TDWP tutorial recommended Simple Local Avatars. The plugin adds an avatar field to user profiles, stores avatar files in the WordPress uploads directory, generates requested image sizes, and can fall back to Gravatar or disable Gravatar according to the site's configuration.

1. Back up the website. Create a current backup before installing or changing a plugin on a production site.
2. Review the plugin listing. Check maintenance status, recent compatibility information, support activity, permissions, and privacy implications before installation.
3. Install and activate the selected avatar plugin. Use Plugins > Add New in the WordPress dashboard and search for the exact plugin name.
4. Edit the user profile. Open your own profile or another registered user's profile, find the new avatar field, and select an image from the Media Library or upload a new one.
5. Save and test the profile. Update the user, then inspect author pages, comments, account screens, and other locations where the theme displays avatars.

Selecting a local avatar plugin

Simple Local Avatars remains one option, and the WordPress plugin directory lists other choices such as One User Avatar and profile-picture plugins that use the Media Library. Do not install several avatar plugins at the same time unless their documentation explicitly supports that setup; overlapping avatar filters can create inconsistent results.

For an existing site, first identify whether another membership, community, ecommerce, learning-management, or forum plugin already controls profile pictures. BuddyPress and similar systems may have their own avatar workflows that should be used instead of a general avatar plugin.

Control avatar display across the site

Site administrators can usually manage public avatar display under Settings > Discussion. Depending on the WordPress version and active plugins, this area can include controls for showing avatars, selecting an allowed rating, and choosing the default image shown when no matching avatar exists.

• Avatar display: Make sure avatars are enabled when you expect profile images to appear in comments or other supported locations.
• Maximum rating: A Gravatar with a rating above the site's permitted level may be replaced by the default image.
• Default avatar: Choose the fallback shown for users and commenters who do not have an approved image.
• Plugin-specific settings: A local-avatar or privacy plugin may add its own controls to this screen or another settings page.

Can an administrator change another user's picture?

A site administrator cannot safely create or change another person's Gravatar unless that person controls the relevant Gravatar or WordPress.com account. A local-avatar plugin may allow an administrator with permission to edit registered users to assign an image from the site's Media Library. This changes the avatar on that WordPress site; it does not change the person's Gravatar across other websites.

This distinction answers the question preserved in the original article discussion: local avatar tools can allow site administrators to add a picture for a registered user, but the administrator should have the person's permission and use an image the site is authorized to publish.

Why the new profile picture is not showing

Confirm the WordPress email

Compare the email under Users > Profile with the address connected to the Gravatar image. Small differences, aliases, and old account addresses can cause the default avatar to appear.

Check verification and image assignment

Make sure the email address is verified and that the uploaded image is assigned to that exact address. Accounts with several email addresses can have different avatars or profile behavior.

Clear caches

Browser caches, WordPress caching plugins, reverse proxies, CDNs, managed-host caches, and avatar services can all retain an older image. Purge only the caches you control, then test in a private browser window.

Review Discussion settings

Verify that avatar display is enabled and that the image rating is allowed. A local-avatar plugin may also have an option that disables Gravatar or limits which user roles may upload pictures.

Check the theme or account plugin

Some themes show a custom author image instead of the normal WordPress avatar. Membership, directory, forum, social-network, and ecommerce plugins can also store profile pictures separately. Review the settings for the component that renders the profile page or author box.

Inspect privacy and security tools

Content-security policies, privacy plugins, browser extensions, firewalls, or blocked external domains can prevent Gravatar images from loading. Local avatars may be preferable when the site's policy intentionally blocks third-party avatar requests.

What changed from the original 2014 guide

The original article correctly explained that WordPress associates profile pictures with email addresses through Gravatar and suggested Simple Local Avatars as an alternative. The revised guide removes outdated dashboard wording, no longer assumes that every user will see one specific default placeholder, and makes a clearer distinction between a global Gravatar and an image stored only on one WordPress site.

Official references

Use the official documentation and plugin listings to confirm current interfaces and maintenance details before changing a live site.