Documentation

Custom Profile Photo WordPress plugin is designed to work out of the box. This documentation exists for clarity, transparency, and confidence — not complexity.

Why Is There Documentation?

Even simple plugins deserve clear explanations. This page exists so users know exactly what the plugin does, how it behaves, and how their data is handled — without guessing or digging through code.

To explain how profile pictures replace Gravatar
To clarify where profile picture data is stored
To answer common questions before users ask for support
To show transparency around security and permissions

Most users will never need this page. It’s here when they do.

Getting Started

1. Install and activate the plugin
2. Go to Users → Profile (or edit any user)
3. Upload or choose an image for the profile picture
4. Crop and save — that’s it

No settings pages. No configuration. The plugin works automatically once activated.

Image Rules & Behavior

Minimum image size: 150 × 150 pixels
Maximum image size: 5000 × 5000 pixels
Square cropping ensures consistent avatars everywhere
Multiple avatar sizes are generated automatically
Removing the image instantly restores Gravatar

Frequently Asked Questions (FAQs)

No. Gravatar is used as a fallback when no custom profile picture is set.

No. Your profile picture will not be deleted. The plugin stores profile picture information safely in the database, and the uploaded image files remain in your WordPress Media uploads folder under a dedicated /profile-picture/ directory.

Deactivating the plugin does not remove any images or data, and Gravatar will automatically be used again as a fallback until the plugin is reactivated.

Yes. There is no Pro version and no feature limitations.

Absolutely. Contributions, translations, and supports are much appreciated. 😊

Custom Profile Photo

Simple WordPress plugin that let you upload, crop, and manage profile pictures without Gravatar.

Download Now

Version:	1.0.0
Last updated:	25 Feb 2026
WordPress version:	5.0 or higher
Tested up to:	6.9
PHP version:	7.4
Languages:	3 (View All)