by
John James Jacoby
4.5 (29 reviews)
WP User Avatars
Allow registered users to upload and select their own avatars.
WP User Avatars ranks #1,296 among WordPress.org plugins with 20,000+ active installations, is #185 of 8,848 in the Customization category, a 4.5/5 rating from 29 reviews, and was last updated Oct 16, 2026. Data from WordPress.org, refreshed twice daily — see methodology.
Compatible with WP 7.1.4
v2.2.0
Current Version v2.2.0
Updated 2 weeks ago
Last Update on 16 Oct, 2026
Refreshed 18 hours ago
Last Refreshed on
#185 of 8,848 in Customization
Top 5% by installs
Downloads -28.6% this week
Actively maintained
Rank
#1,296
—
No change
Active Installs
20K+
-17.4%
KW Avg Position
34
0.3 better
Downloads
357.5K
+25 today
Support Resolved
0%
—
No change
Rating
90%
Review 4.5 out of 5
4.5
(29 reviews)
Next Milestone 30K
20K+
30K+
213
Ranks to Climb
-
Growth Needed
8,000,000
Active Installs
Pro
Unlock Exact Install Count
See the precise estimated active installs for this plugin, calculated from real-time ranking data.
- Exact install estimates within tiers
- Track install growth over time
- Milestone progress predictions
Need 5,773 more installs to reach 30K+
Rank Changes
Current
#1,296
Change
Best
#
Downloads Growth
Downloads
Growth
Peak
Upgrade to Pro
Unlock 30-day, 90-day, and yearly download history charts with a Pro subscription.
Upgrade NowReviews & Ratings
4.5
29 reviews
Overall
90%
5
24
(83%)
4
0
(0%)
3
2
(7%)
2
2
(7%)
1
1
(3%)
Support Threads Overview
Resolved
Unresolved
1
Total Threads
0
Resolved
1
Unresolved
0%
Resolution Rate
Security History
Source: WPVulnerabilityNo known vulnerabilities on record for WP User Avatars. Checked 1 week ago.
Track This Plugin
Get detailed analytics, keyword tracking, and position alerts delivered to your inbox.
Start Tracking FreePlugin Details
- Version
- 2.2.0
- Last Updated
- Oct 16, 2026
- Requires WP
- 6.4+
- Tested Up To
- 7.1.4
- PHP Version
- 7.4 or higher
- Author
- John James Jacoby
Support & Rating
- Rating
- ★ ★ ★ ★ ★ 4.5
- Reviews
- 29
- Support Threads
- 1
- Resolved
- 0%
Keywords
Upgrade to Pro
Unlock keyword rankings, search positions, and detailed analytics with a Pro subscription.
Upgrade NowSimilar Plugins
Adminify – White Label, Admin Menu Editor, Login Customizer
6K+ installs
#2,757
Master Addons for Elementor – Elementor Addons, Widgets, Mega Menu Builder, Popup Builder, Widget Builder & Template Kits
30K+ installs
#1,015
Elementor Website Builder – more than just a page builder
10M+ installs
#1
LiteSpeed Cache
7M+ installs
#5
Ultimate Addons for Elementor – Widgets, Templates, WooCommerce & Header Footer Builder
2M+ installs
#26
Essential Addons for Elementor – Popular Elementor Templates & Widgets
1M+ installs
#29
Starter Templates: AI-Powered Website Templates for Elementor & Gutenberg
1M+ installs
#34
Custom Post Type UI
1M+ installs
#50
One Click Demo Import
1M+ installs
#62
Translate WordPress with GTranslate
900K+ installs
#71
TL;DR
AI summary of the plugin's readmeThis plugin is for site administrators who let registered users manage their own profile images. It solves the problem of not having built-in avatar uploading by allowing users to upload and select their own avatars.
- Upload custom avatars
- Select own avatars
Frequently Asked Questions
Common questions about WP User Avatars
The project wiki covers setup, the front-end editor, theme and plugin integration, multisite and remote storage, migration and compatibility, and capability-based customization.
It works OK, but you'll want to consider exactly what level of privacy is best for your installation.
Add the User Avatar Editor block or [wp_user_avatars] shortcode to an existing page. Both display the avatar editor for the signed-in user and do not create a profile page, registration flow, or membership system. The block adds no heading or description by default. Add either inline in the editor when the surrounding page needs more context. The block also supports background, text, border, spacing, typography, and wide-alignment controls. The shortcode uses the same avatar capabilities, upload restrictions, ratings, and Media Library permissions as the WordPress profile and bbPress profile integrations. Users without Media Library access can still upload their own avatar when the site's avatar permissions allow it. Uploads can include a rating without JavaScript. Rating changes and removal also work without JavaScript when an avatar already exists. Choosing an existing Media Library image requires JavaScript. Theme and plugin developers can render the same current-user editor with wp_user_avatars_get_editor(). The front-end editor uses semantic form groups instead of WordPress admin table markup. Themes can customize the wp-user-avatars-frontend-form classes. The block exposes --wp-user-avatars-card-* CSS custom properties on its wrapper. The block controls and shortcode expose --wp-user-avatars-button-* and --wp-user-avatars-primary-* properties on the block wrapper or an ancestor of the shortcode.
Choose a square Custom Default Avatar from the Media Library under Settings > Discussion. The selected image becomes an ordinary WordPress default for users who do not have an individual avatar. It is a site-level fallback and does not write avatar metadata to every user. Rectangular images are rejected to prevent distortion. The setting is site-specific on multisite. Mystery Person and Blank remain available. Enable Block Gravatar when the selected fallback should be served directly without a Gravatar request.
WP User Avatars uses the image size requested by WordPress. Ask for the intended display size instead of enlarging the default 96-pixel image with CSS: echo get_avatar( get_the_author_meta( 'ID' ), 256 );
$url = get_avatar_url( $user_id, array( 'size' => 256 ) ); WordPress requests a 2x source for get_avatar(), so the first example can also provide a sharper image on high-density displays when the uploaded source is large enough. Theme builders need to expose or pass the intended avatar size; CSS alone cannot recover detail from a 96-pixel URL.
WordPress creates avatar image markup. Pass meaningful alternative text as the fourth argument to get_avatar() when the avatar conveys information: echo get_avatar( $user_id, 96, '', 'Portrait of Jane Doe' ); WordPress escapes that value when it creates the HTML attribute. WP User Avatars supplies the image URL and preserves the caller's alternative text. It does not copy alternative text from a Media Library attachment. A directly uploaded avatar may not have an attachment, and WordPress uses the same empty value when a caller omits alternative text or deliberately marks an avatar as decorative. Leave the fourth argument empty when nearby text already identifies the person and the avatar adds no information. Themes that build their own <img> markup must set the alt attribute themselves.
WP User Avatars creates a square derivative the first time WordPress requests an uncached size for a directly uploaded avatar. To disable future plugin-owned dynamic resizing, add this to a site plugin, must-use plugin, or your theme's functions.php file: add_filter( 'wp_user_avatars_dynamic_resize', '__return_false' ); To allow only selected sizes, inspect the requested size with the same filter: add_filter( 'wp_user_avatars_dynamic_resize', function ( $resize, $user_id, $size ) { $allowed_sizes = array( 96, 192, 256, 512 ); return $resize && in_array( (int) $size, $allowed_sizes, true ); }, 10, 3 ); For a directly uploaded avatar or a locally stored Media Library attachment, a disallowed uncached request falls back to the original full-size URL. A derivative that was already cached remains available. Disallowing a size does not delete existing files or change stored avatar data. Remotely stored Media Library attachments continue to use WordPress image-size resolution.
Community: https://wordpress.org/support/plugin/wp-user-avatars Development: https://github.com/stuttter/wp-user-avatars/discussions
