Title: Avatarly
Author: saumya010
Published: July 23, 2026
Last modified: July 25, 2026
---
Search plugins
# Avatarly
By [saumya010](https://profiles.wordpress.org/saumya010/)
[Download](https://downloads.wordpress.org/plugin/avatarly.1.0.2.zip)
* [Details](https://wordpress.org/plugins/avatarly/#description)
* [Reviews](https://wordpress.org/plugins/avatarly/#reviews)
* [Installation](https://wordpress.org/plugins/avatarly/#installation)
* [Development](https://wordpress.org/plugins/avatarly/#developers)
[Support](https://wordpress.org/support/plugin/avatarly/)
## Description
Avatarly adds a local, self-hosted avatar system to WordPress. Users can upload
a profile picture directly on your site instead of relying on Gravatar, and site
owners get full control over who’s allowed to upload, how avatars look, and where
uploads are permitted.
**Three ways to let users manage their avatar on the front end:**
* **Shortcode** — `[avatarly]`
* **Widget** — add the “Avatarly (Legacy)” widget to any sidebar (classic, non-
block themes)
* **Gutenberg block** — search for “Avatarly” in the block inserter
Avatars can also always be managed from the standard WordPress **Edit Profile**
screen.
**Key features**
* Local avatar storage — no data sent to Gravatar unless you choose to keep it
as a fallback.
* Drag-and-drop / AJAX upload on the front end (progressively enhanced; falls back
to a normal form for no-JS visitors).
* Built-in crop and reposition popup: drag to pan and use the zoom slider to frame
the shot before saving, or skip it to use the automatic center crop.
* Strict upload validation: real MIME/extension checks, image verification, and
file-size limits — not just a filename blacklist.
* Automatic EXIF/GPS metadata stripping from uploaded images.
* Fine-grained permissions: restrict uploads by capability and/or by specific roles.
* A dedicated **Styling** tab: size, shape (circle/rounded/square), border, shadow,
accent color, and button text.
* Optional automatic cleanup of avatar files when a user account is deleted.
* Translation ready.
#### Developer hooks
* `avatarly_avatar_size` (filter) — change the avatar size used when generating
a sized copy.
* `avatarly_avatar_data` (filter) — filter the final avatar data array.
* `avatarly_avatar_html` (filter) — filter the rendered `![]()
` HTML.
* `avatarly_avatar_uploaded` (action) — fires after a successful upload.
* `avatarly_avatar_deleted` (action) — fires after an avatar is removed.
## Blocks
This plugin provides 1 block.
* Avatarly Lets the logged-in user upload or remove their local avatar.
## Installation
1. Upload the `avatarly` folder to `/wp-content/plugins/`, or install it through the
Plugins screen directly.
2. Activate the plugin through the “Plugins” screen in WordPress.
3. Visit **Settings Avatarly** to configure permissions and styling.
4. Add the `[avatarly]` shortcode to a page, add the “Avatarly (Legacy)” widget to
a sidebar, or insert the “Avatarly” block wherever logged-in users need to manage
their avatar.
## FAQ
### Does this replace Gravatar entirely?
No, by default it layers on top: if a user hasn’t uploaded a local avatar, WordPress
falls back to Gravatar (or your configured default) as usual. You can disable that
fallback in Settings Avatarly General & Permissions.
### What image types are supported?
JPG, PNG, GIF, and WebP.
### Can I choose which part of my photo is used?
Yes. When you select or drop an image, a crop popup lets you drag to reposition
and zoom before saving. Selecting “Skip” uploads the image with an automatic center
crop instead.
### Can I restrict who is allowed to upload an avatar?
Yes. Under Settings Avatarly General & Permissions you can require the `upload_files`
capability and/or restrict uploads to specific roles.
### Where are avatar files stored?
In `wp-content/uploads/avatarly/`, following WordPress’s standard year/month upload
structure.
### What happens to avatar files if I delete a user?
By default nothing is deleted automatically. You can enable automatic cleanup on
user deletion in the General & Permissions tab.
## Reviews
There are no reviews for this plugin.
## Contributors & Developers
“Avatarly” is open source software. The following people have contributed to this
plugin.
Contributors
* [ saumya010 ](https://profiles.wordpress.org/saumya010/)
[Translate “Avatarly” into your language.](https://translate.wordpress.org/projects/wp-plugins/avatarly)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/avatarly/), check out
the [SVN repository](https://plugins.svn.wordpress.org/avatarly/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/avatarly/) by [RSS](https://plugins.trac.wordpress.org/log/avatarly/?limit=100&mode=stop_on_copy&format=rss).
## Changelog
#### 1.0.2
* Security hardening: the avatar uploads subfolder now writes its own .htaccess/
index.php to deny script execution as a defense-in-depth measure, and the upload/
delete REST endpoints are now rate-limited per user.
#### 1.0.1
* Removed the Custom CSS settings field. Per WordPress.org plugin guidelines, plugins
may not let users save arbitrary custom CSS/JS/PHP; all supported styling (size,
shape, border, shadow, accent color) is already exposed as dedicated controls
in Settings Avatarly Styling.
#### 1.0.0
* Initial release, including a crop/reposition popup (drag to pan, zoom slider,
skippable) for the front-end upload flow.
## Meta
* Version **1.0.2**
* Last updated **3 hours ago**
* Active installations **Fewer than 10**
* WordPress version ** 6.3 or higher **
* Tested up to **7.0.2**
* PHP version ** 7.4 or higher **
* Tags
* [avatar](https://wordpress.org/plugins/tags/avatar/)[gravatar](https://wordpress.org/plugins/tags/gravatar/)
[profile picture](https://wordpress.org/plugins/tags/profile-picture/)[upload](https://wordpress.org/plugins/tags/upload/)
[user profile](https://wordpress.org/plugins/tags/user-profile/)
* [Advanced View](https://wordpress.org/plugins/avatarly/advanced/)
## Ratings
No reviews have been submitted yet.
[Your review](https://wordpress.org/support/plugin/avatarly/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/avatarly/reviews/)
## Contributors
* [ saumya010 ](https://profiles.wordpress.org/saumya010/)
## Support
Got something to say? Need help?
[View support forum](https://wordpress.org/support/plugin/avatarly/)