Custom Profile Picture – Replace Gravatar with Your Own Images
Replace default Gravatars with custom profile pictures! Upload from media library or device. Bulk manage all users from one beautiful admin page.
Solid choice
Custom Profile Picture is a solid plugin choice in 2026, with a few things worth checking first. It runs on 300+ sites, is rated 4/5 and was last updated 3 months ago, and scores 62/100 on our health check.
- Small user base (300+ active installs)
- Very few reviews so far
How does it stack up?
Side-by-side on installs, updates, ratings & support
Daily downloads
Download spikes usually follow a new release — each site that auto-updates counts as a download.
Rankings
Where Custom Profile Picture stands todayWordPress.org search rankings
Live position in the plugin search, top 100| Keyword | Position |
|---|---|
| avatar | #45 |
| custom avatar | #12 |
| gravatar | #4 |
| profile picture | #4 |
| user profile | #37 |
Version adoption
Share of active sites per release.
Rating breakdown
★★★★★★★★★★ 4 from 4 reviews
About Custom Profile Picture
From the official readme · v1.0.7Description
Custom Profile Picture is the easiest way to replace WordPress default Gravatar avatars with custom profile pictures. Upload images directly or choose from your media library – managing user avatars has never been this simple!
🚀 Why Choose Custom Profile Picture?
Tired of relying on Gravatar for user avatars? Want complete control over your site’s user profile pictures? This plugin gives you the freedom to upload custom profile pictures without depending on external services.
✨ Key Features
📸 Dual Upload Methods
* Upload images directly from your device
* Choose from WordPress Media Library
* Both methods available on individual user profiles
🌐 Frontend Shortcode
* Add [custom_profile_picture] to any page or post
* Logged-in users can upload, crop, and remove their own picture directly on the frontend
* Interactive crop tool — no page reload required
* Works without giving users access to the admin area
⚡ Centralized Management Dashboard
* Manage ALL user profile pictures from one page
* Beautiful grid view of all users
* Hover to change or remove pictures instantly
* AJAX-powered updates – no page refresh needed
* Search users by name, email, or username
* Pagination for sites with many users
🎨 Professional Image Cropping
* Built-in interactive cropping tool
* Real-time crop preview
* Maintains perfect square aspect ratio
* Mobile-friendly interface
🔒 Security First
* Proper nonce verification
* Capability checks for user permissions
* Secure AJAX handling
* Sanitized and validated inputs
📱 Fully Responsive
* Works perfectly on desktop, tablet, and mobile
* Touch-friendly controls
* Responsive admin interface
⚙️ Developer Friendly
* Clean, object-oriented code
* Proper WordPress coding standards
* Namespaced classes
* Well-documented code
* Extensible architecture
💡 Perfect For
- Community websites
- Membership sites
- Corporate intranets
- Educational platforms
- Any site wanting custom user avatars
- Sites not wanting to depend on Gravatar
🎯 How It Works
Method 1: Individual User Profiles
1. Go to Users → Your Profile (or edit any user)
2. Scroll to “Profile Picture” section
3. Click “Choose from Media Library” OR upload directly
4. Image automatically replaces Gravatar everywhere
Method 2: Bulk Management (Admin)
1. Go to “Profile Pictures” in admin menu
2. See all users in a beautiful grid layout
3. Hover over any user’s avatar
4. Click “Change” to select from media library
5. Click “Remove” to revert to Gravatar
🌟 What Makes This Plugin Special?
Unlike other avatar plugins, Custom Profile Picture offers:
* No configuration needed – works out of the box
* Dual interface – individual and bulk management
* Media library integration – use existing images
* Beautiful UX – modern, intuitive design
* Lightweight – no bloat, just what you need
* 100% WordPress compatible – uses standard avatar system
🔧 Technical Details
- Integrates seamlessly with WordPress avatar system
- Works with
get_avatar()function - Replaces avatars site-wide automatically
- Stores images in WordPress media library
- Clean database structure with user meta
- No external dependencies (except Cropper.js for cropping)
📚 Documentation & Support
Need help? Check out our:
* Documentation
* Support Forum
Shortcodes
[custom_profile_picture]
Place this shortcode on any page or post to give logged-in users a self-service profile picture uploader on the public-facing site.
Features:
* Displays the user’s current avatar (custom or Gravatar)
* “Upload New Picture” triggers a built-in crop tool (square aspect ratio)
* “Remove Picture” reverts the avatar back to Gravatar
* AJAX-powered — no page reload needed
* Guests or logged-out visitors see a prompt to sign in
Example:
[custom_profile_picture]
You can place it inside any page, post, or widget area that supports shortcodes.
Additional Information
Credits
- Cropper.js library for image manipulation
- WordPress core team for the amazing platform
Privacy Policy
This plugin does not collect, store, or transmit any user data outside your WordPress installation. All images are stored in your WordPress media library. No external services are used.
Custom Profile Picture – Replace Gravatar with Your Own Images uses Appsero SDK to collect some telemetry data upon user’s confirmation. This helps us to troubleshoot problems faster & make product improvements.
Appsero SDK does not gather any data by default. The SDK only starts gathering basic telemetry data when a user allows it via the admin notice. We collect the data to ensure a great user experience for all our users.
Integrating Appsero SDK DOES NOT IMMEDIATELY start gathering data, without confirmation from users in any case.
Learn more about how Appsero collects and uses this data.
Want to Contribute?
We welcome contributions! Visit our GitHub repository to report issues or submit pull requests.
Love This Plugin?
- Leave a review – it helps others find this plugin!
- Donate – support continued development
For Developers
Custom Profile Picture is built with:
* Object-oriented PHP
* WordPress coding standards
* Proper namespacing (Ifatwp\CustomProfilePicture)
* Action and filter hooks
* AJAX for dynamic updates
* WordPress Media Library API
* Clean, documented code
Filters available:
* Custom hooks coming in future versions
For questions, customizations, or feature requests, please visit the support forum.`
Installation
Automatic Installation
- Go to Plugins → Add New
- Search for “Custom Profile Picture”
- Click “Install Now”
- Activate the plugin
- Done! Start uploading profile pictures
Manual Installation
- Download the plugin ZIP file
- Go to Plugins → Add New → Upload Plugin
- Choose the downloaded file
- Click “Install Now”
- Activate the plugin
Usage
For Individual Users (Admin):
1. Navigate to Users → Your Profile
2. Find “Profile Picture” section
3. Upload or choose from media library
4. Save changes
For Frontend Users via Shortcode:
1. Add the [custom_profile_picture] shortcode to any page or post
2. Logged-in users will see their current profile picture with “Upload New Picture” and (if set) “Remove Picture” buttons
3. Clicking “Upload New Picture” opens a built-in crop tool — save to update immediately, no page reload needed
4. Guests or logged-out users see a polite sign-in prompt
For Administrators:
1. Go to “Profile Pictures” in WordPress admin menu
2. View all users in grid layout
3. Hover over user avatars to manage
4. Use search to find specific users
Frequently asked questions
Does this work with Gravatar?
Yes! The plugin replaces Gravatar with custom images. If no custom image is uploaded, the default Gravatar will still show.
What image formats are supported?
All standard web formats: JPEG, JPG, PNG, and GIF.
What’s the recommended image size?
We recommend 150×150 pixels for optimal display across all devices.
Can users upload their own profile pictures?
Yes! Users can upload their own pictures from their profile page. Admins can manage all user pictures from the centralized dashboard.
Will this affect my site’s performance?
No! The plugin is lightweight and only loads on relevant admin pages. Images are stored in WordPress media library using WordPress’s own optimization.
Can I bulk upload profile pictures?
Yes! Use the “Profile Pictures” admin page to manage multiple users quickly from one interface.
Does it work with BuddyPress or other profile plugins?
Yes, if they use WordPress’s standard get_avatar() function. The plugin integrates with WordPress’s core avatar system.
Can I remove a custom profile picture?
Absolutely! Just click the “Remove” button on the admin page or delete it from the user’s profile page. The avatar will revert to Gravatar.
Is the plugin translation ready?
Yes! All strings are translatable using WordPress’s translation system.
Does it work with multisite?
Yes! The plugin is multisite compatible.
Changelog
CRITICAL PERFORMANCE UPDATE! Fixes massive database query issues that caused slow page loads. Reduces queries by up to 90%. If you experienced performance problems with previous versions, this update is essential. Highly recommended for all users!
1.0.7
- FIXED: Fatal error (
Illegal offset type in isset or empty) when theget_avatar_urlfilter received aWP_User/WP_Post/WP_Commentobject instead of a numeric ID. This crashed the block editor (and any REST request preloading/wp/v2/users/me). All avatar filters now resolve every$id_or_emailshape — integer ID, email,WP_User,WP_Post, andWP_Comment— to a numeric user ID before use. - FIXED:
pre_get_avatar_datahandler read the user ID from the wrong filter argument, so custom avatars were never injected via that path. It now reads the correct$id_or_emailargument.
1.0.6
- FIXED:
[custom_profile_picture]shortcode upload now works for all logged-in users. The crop-save AJAX handler previously required theupload_filescapability, which Subscribers (the primary audience of the frontend shortcode) do not have, causing a “Permission denied” error. Users can now always update their own picture, while editing another user’s picture still requires theedit_usercapability. - FIXED:
[custom_profile_picture]shortcode assets (cropper scripts/styles) now load in block (FSE) themes. Previously the enqueue was gated onhas_shortcode($post->post_content), which fails when the shortcode lives in a block template, template part, or synced pattern, leaving the uploader non-functional. Assets are now enqueued directly from the shortcode render.
1.0.5
- FIXED:
get_avatar_urlandpre_get_avatar_datafilters now correctly resolve any$id_or_emailvalue (integer ID, email string, or WP_Comment object), so custom avatars display properly on the frontend in all contexts. - NEW:
[custom_profile_picture]shortcode — lets logged-in users upload, crop, and remove their own profile picture on any public page without admin access. - NEW: AJAX remove action available on the frontend (
custprofpic_frontend_remove_picture). -
NEW: Dedicated frontend CSS (
frontend-profile.css) and JS (frontend-upload.js) — loaded only on pages that contain the shortcode.
Added – Appsero insight vendor
Critical Performance Update – Highly Recommended -
FIXED: Massive database query optimization – eliminated expensive
attachment_url_to_postid()calls - PERFORMANCE: Reduced database queries by up to 90% on pages with multiple avatars
- OPTIMIZED: Added object caching to prevent repeated queries for same user
- IMPROVED: Ensured attachment ID is always stored when uploading profile pictures
- FIXED: Removed duplicate admin notice hook that could cause unnecessary notices
- ENHANCED: Better performance on comment sections and user listing pages
This update addresses user concerns about excessive database queries. If you experienced slow page loads with previous versions, this update will significantly improve performance.
1.0.2 – January 8, 2026
Major Update – New Features & Improvements
- NEW: Centralized admin page for bulk profile picture management
- NEW: Beautiful grid view of all users with avatars
- NEW: Media library integration on user profiles
- NEW: Hover actions – change/remove pictures instantly
- NEW: User search functionality by name, email, username
- NEW: AJAX-powered updates without page refresh
- NEW: Pagination support for large user bases
- IMPROVED: Smaller, more compact user cards for better overview
- IMPROVED: Better responsive design for mobile/tablet
- IMPROVED: Fixed header alignment and search box layout
- IMPROVED: Enhanced UX with toast notifications
- IMPROVED: Better attachment ID tracking for media library images
- ADDED: Real-time image preview updates
- ADDED: Success/error notification system
- ADDED: Loading states for better user feedback
- OPTIMIZED: CSS for better performance and smaller file size
- FIXED: Email display now shows on hover to save space
- FIXED: Responsive search form for mobile devices
1.0.1 – July 21, 2025
- IMPROVED: Added proper namespacing for better code organization
- IMPROVED: Enhanced error handling for image uploads
- ENHANCED: Security with additional nonce verification
- ADDED: Responsive styling for mobile devices
- FIXED: Image preview display issues
- IMPROVED: Cropping interface usability
- ENHANCED: Proper sanitization for AJAX requests
- ADDED: Alt text for better accessibility
1.0.0 – Initial Release
- ADDED: Image upload functionality
- ADDED: Interactive image cropping with Cropper.js
- ADDED: AJAX-based image saving
- ADDED: Responsive modal design
- ADDED: Security with nonce verification
- ADDED: Input sanitization and validation
- ADDED: Avatar replacement system
- ADDED: User profile integration
For developers
Is this your plugin? Show off the numbers.
Add a live badge to your site, docs or GitHub README. It updates on its own — no account needed.
Best Custom Profile Picture alternatives
All avatar plugins →
FAQ
Custom Profile Picture: quick answers
Straight answers, pulled from live WordPress.org data.
Live data from WordPress.org · checked Oct 4, 2026
Is Custom Profile Picture free?
Yes. Custom Profile Picture is free to download and use from the official WordPress.org plugin directory.
Is Custom Profile Picture safe to use in 2026?
Custom Profile Picture is a solid plugin choice in 2026, with a few things worth checking first. It runs on 300+ sites, is rated 4/5 and was last updated 3 months ago, and scores 62/100 on our health check.
How many websites use Custom Profile Picture?
Custom Profile Picture is active on 300+ WordPress websites and has been downloaded 1,986 times since it launched in July 2025. It was downloaded 218 times in the last 30 days.
Does Custom Profile Picture work with WordPress 7.1?
Custom Profile Picture is officially tested up to WordPress 7.0.6, while the latest release is 7.1.2. It may still work, but try it on a staging site first.
What PHP version does Custom Profile Picture need?
Custom Profile Picture requires PHP 7.4 or higher. Most hosts run PHP 8.x today, so it works on any modern WordPress hosting.
When was Custom Profile Picture last updated?
The latest version, 1.0.7, was released on June 29, 2026 (3 months ago).
Who makes Custom Profile Picture?
Custom Profile Picture is developed and maintained by Iftakharul Islam.
What are the best alternatives to Custom Profile Picture?
The most popular alternatives to Custom Profile Picture are Gravatar Enhanced (100K+ installs), Simple Local Avatars (100K+ installs) and One User Avatar (100K+ installs).
Powered by PageForge
Want thousands of pages that rank like these? Build them in an afternoon.
This directory runs on the same engine as PageForge. Turn any spreadsheet, CSV or API into thousands of fast, SEO-ready WordPress pages — with schema, internal links and AI-written copy baked in.
- CSV, Google Sheets & API data sources
- AI content, schema & internal links per page
- Works with Elementor, Gutenberg, Yoast & Rank Math
- Free on WordPress.org — no credit card
