A Gravatar, short for Globally Recognized Avatar, is your profile for commenting on blogs, posting to forums, or any other site using the Gravatar feature. In this guide, you will learn how to set up your Gravatar profile and how to add it to your site.
Gravatar information also appears in Hovercards, which show when people mouse over the avatar image shown in comments and other places.

Upload an image to use as the avatar for your Gravatar profile by following these steps:
- Visit your WordPress.com dashboard.
- Hover over your profile in the top-right of your dashboard, and select the “My WordPress Account” button.
- Click My Profile to visit your profile settings.
- Click the “Edit your public avatar” link below the image placeholder.

- Click the “Upload Image” button to upload an image from your computer or the “Use Camera” button to take a picture.
- Customize your image by adjusting the size or applying filters.
- When you’re done, click the checkmark button in the top-right, then close the pop-over.

You can remove an avatar, restoring the default placeholder image, by following these steps:
- In your WordPress.com profile, click My Profile to visit your profile settings.
- Click the “Edit your public avatar” link below the image placeholder.
- Click the horizontal ellipsis in the avatar preview.
- Select the Delete option from the drop-down and confirm that you’re sure you want to delete the image.
- Close the pop-over window.

Your Gravatar will show up any time you comment on a blog or post to the support forums. You can also add your Gravatar to your site through a few methods.
You can add your Gravatar, or the Gravatar of another member of your team, to your site by following these steps:
- Edit a page, post, or template.
- Click the “+ Block Inserter” icon.
- Search for “Gravatar Profile”.
- Click the Gravatar Profile icon to add it to your content.
In the block settings, you can select the user to appear:
- Author: The author of the page or post.
- User: Select another member of your team to display their Gravatar.
- Custom email: Enter the email address of another Gravatar user to display their Gravatar profile.
The Gravatar shortcode allows you to embed a Gravatar image into a post, page, or text widget.
- Edit the page or post that you want to add your Gravatar to
- Add the Shortcode Block by typing
/shortcode
or using the Block Inserter Icon to add the Shortcode block - Enter the following shortcode, replacing
user@yourgroovy.com
with the email address associated with your gravatar
[gravatar email="user@yourgroovy.com" size="128"]
You’ll also be able to customize the following layout options:
- Size: Set a custom size for the image. Remember, Gravatars are square and the max upload size is 512px by 512px so setting a size larger than this may be blurry.
- Rating: Ratings are self-defined by the uploader. This lets you choose the minimum rating for an image to appear.
Note: The instructions in this section are referring to themes that use the Classic Editor. If you are using the WordPress block editor, please use the Gravatar block or shortcode instead.
The Gravatar widget allows you to display a Gravatar image along with some custom text. This is ideal for displaying a brief About Me section on your blog sidebar or footer areas.
Here’s an example of what it looks like:

To add a Gravatar Widget:
- Go to My Site → Appearance → Customize → Widgets
- Click the Block Inserter icon, and type in
gravatar
to see your Gravatar widget options - Click on the Gravatar icon to add the widget

Once you add the widget to your site, you’ll see the following widget settings:
Title – The title of your Gravatar image. (i.e., About Me, About the Author)
Select a user – Select a registered user of your blog, or pick custom and enter an email address in the box below.
Size – Select a size for the Gravatar image (small, medium, large, extra-large).
Alignment – Select an alignment for the Gravatar. Left and right will allow the text to flow on either side of the image, while center will put the image in the center. No alignment will place the text underneath the image.
Gravatar link – If you want your Gravatar image to link to another page (i.e., your About Me page), enter a URL here.
Text – Enter the text (HTML allowed) you want to display with your Gravatar.
Note: The instructions in this section are referring to themes that use the Classic Editor. If you are using the WordPress block editor, please use the Gravatar block or shortcode instead.
The Gravatar Profile Widget allows you to pull in your Gravatar image along with more of your Gravatar profile data than the Gravatar Widget.
Here’s an example of what it looks like:

For example, to add a Gravatar Profile widget:
- Go to My Site → Appearance → Customize → Widgets
- Click the Block Inserter icon, and type in
gravatar
to see your Gravatar widget options - Click on the Gravatar Profile icon to add the widget

Once you add the widget to your site, you’ll see the following widget settings:
Title – The title of your Gravatar profile block. (i.e., About Me, About the Author)
Select a user – Select a registered user of your blog, or pick custom and enter an email address in the box below. Users may have multiple addresses on a single Gravatar account, but only the primary address displays profile information.
Show Personal Links – Allows you to display links to your websites, blogs, or other sites that help describe who you are. You can manage your links at Gravatar.com.
Show Account Links – This allows you to display links to profiles that you use across the web. These account links come from verifying services on Gravatar. You can manage your verified accounts at Gravatar.com.
- If you change your email address, you may need to go to My Gravatars and re-assign your Gravatar to your new email address.
- If the pop-up for Gravatar doesn’t work, you can visit gravatar.com directly.
- If you change your avatar, it may take a few hours to show because of our cache. You may clear your browser’s cache to immediately see the change.
- There are several avatar display options available in the Discussion Settings. Gravatar image appears on the widgets only if the Show Avatars setting is enabled in the Discussion Settings.
- If your Gravatar is set but not showing up on blog pages, it may be because the image rating is too high. You can check and change image ratings on gravatar.com.
For more information, please visit the gravatar.com support page.