by Iftakharul Islam on WordPress.org
Replace default Gravatars with custom profile pictures! Upload from media library or device. Bulk manage all users from one beautiful admin page.
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!
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.
📸 Dual Upload Methods
* Upload images directly from your device
* Choose from WordPress Media Library
* Both methods available on individual user profiles
⚡ 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
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
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
get_avatar() functionNeed help? Check out our:
* Documentation
* Support Forum
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.
We welcome contributions! Visit our GitHub repository to report issues or submit pull requests.
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.`