Title: WP User Avatars
Author: John James Jacoby
Published: <strong>15 de octubre de  2015</strong>
Last modified: 6 de octubre de  2026

---

Buscar plugins

![](https://ps.w.org/wp-user-avatars/assets/banner-772x250.png?rev=3738638)

![](https://ps.w.org/wp-user-avatars/assets/icon-256x256.png?rev=3738638)

# WP User Avatars

 Por [John James Jacoby](https://profiles.wordpress.org/johnjamesjacoby/)

[Descargar](https://downloads.wordpress.org/plugin/wp-user-avatars.2.1.0.zip)

 * [Detalles](https://es-ar.wordpress.org/plugins/wp-user-avatars/#description)
 * [Valoraciones](https://es-ar.wordpress.org/plugins/wp-user-avatars/#reviews)
 *  [Instalación](https://es-ar.wordpress.org/plugins/wp-user-avatars/#installation)
 * [Desarrollo](https://es-ar.wordpress.org/plugins/wp-user-avatars/#developers)

 [Soporte](https://wordpress.org/support/plugin/wp-user-avatars/)

## Descripción

Allow registered users to upload & select their own avatars.

#### Recommended Plugins

If you like this plugin, you’ll probably like these!

 * [WP User Profiles](https://wordpress.org/plugins/wp-user-profiles/)
 * [WP User Activity](https://wordpress.org/plugins/wp-user-activity/)
 * [WP User Avatars](https://wordpress.org/plugins/wp-user-avatars/)
 * [WP User Groups](https://wordpress.org/plugins/wp-user-groups/)
 * [WP User Signups](https://wordpress.org/plugins/wp-user-signups/)
 * [WP Term Authors](https://wordpress.org/plugins/wp-term-authors/)
 * [WP Term Colors](https://wordpress.org/plugins/wp-term-colors/)
 * [WP Term Families](https://wordpress.org/plugins/wp-term-families/)
 * [WP Term Icons](https://wordpress.org/plugins/wp-term-icons/)
 * [WP Term Images](https://wordpress.org/plugins/wp-term-images/)
 * [WP Term Locks](https://wordpress.org/plugins/wp-term-locks/)
 * [WP Term Order](https://wordpress.org/plugins/wp-term-order/)
 * [WP Term Visibility](https://wordpress.org/plugins/wp-term-visibility/)
 * [WP Media Categories](https://wordpress.org/plugins/wp-media-categories/)
 * [WP Pretty Filters](https://wordpress.org/plugins/wp-pretty-filters/)
 * [WP Chosen](https://wordpress.org/plugins/wp-chosen/)

## Capturas

[⌊Your Profile (+1100px)⌉⌊Your Profile (+1100px)⌉[

Your Profile (+1100px)

[⌊Your Profile (-1100px)⌉⌊Your Profile (-1100px)⌉[

Your Profile (-1100px)

[⌊WP User Profiles (Side)⌉⌊WP User Profiles (Side)⌉[

WP User Profiles (Side)

[⌊WP User Profiles (Normal)⌉⌊WP User Profiles (Normal)⌉[

WP User Profiles (Normal)

## Bloques

Este plugin provee 1 bloque.

 *   User Avatar Editor Let the signed-in user update their avatar.

## Instalación

 * Download and install using the built in WordPress plugin installer.
 * Activate in the “Plugins” area of your admin by clicking the “Activate” link.
 * No further setup or configuration is necessary.

## Preguntas frecuentes

### How does this work with multisite?

It works OK, but you’ll want to consider exactly what level of privacy is best for
your installation.

### How do I add the avatar editor to a normal page?

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.

### How do I display a larger or sharper avatar?

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 );
    ```

When you only need the URL, pass the size explicitly:

    ```
    $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.

### How do I set alternative text for an avatar?

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.

### How do I limit generated avatar sizes?

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.

### Where can I get support?

 * Community: https://wordpress.org/support/plugin/wp-user-avatars
 * Development: https://github.com/stuttter/wp-user-avatars/discussions

## Reseñas

![](https://secure.gravatar.com/avatar/6cfc8c01f1ea3a75ec6f7dba8f2a014ef4cca4fd63a50fb3c8772e492e472ecc?
s=60&d=retro&r=g)

### 󠀁[Replaces Gravatar](https://wordpress.org/support/topic/replaces-gravatar/)󠁿

 [Dennis Bareis](https://profiles.wordpress.org/dbareis/) 16 de diciembre de 2023

Very simplistic (which to some people is good) but not only do I want one that supplements
Gravatar but has user support, this one is abandoned.

![](https://secure.gravatar.com/avatar/9595ff95ac5c432d1b649b4ddf816792ba8b0f92fe55d062574cc50a8f5d365e?
s=60&d=retro&r=g)

### 󠀁[Does not replace WP User Avatar](https://wordpress.org/support/topic/does-not-replace-wp-user-avatar/)󠁿

 [ctmartin2020](https://profiles.wordpress.org/ctmartin2020/) 20 de abril de 2022

A lot of people seem to think this replaces the former WP User Avatar… it does not.
First, it appears that support is seriously lacking here… look at the numerous support
questions left unanswered. A couple that particularly interested me had to do with
whether it was possible to allow users to upload their avatar from the frontend.
I do not give users access to the Wordpress Admin User page. The old WP User Avatar
had a nice simple shortcode which I could use on the frontend. I find there is ZERO
documentation here for this plugin and even looking through the code I can find 
NO shortcode for use on the frontend… so even though those support questions went
unanswered, I can see why: there is NO support for user avatar uploads on the frontend.
So the bottom line is, if you're looking for something that provides an interface
for users on the frontend (like the old WP User Avatar), this plugin will NOT do
what you need. One User Avatar does.

![](https://secure.gravatar.com/avatar/cb341c2cf046dde8f2f85f7bf226a9787425c3227dc00dc072741262c71d910b?
s=60&d=retro&r=g)

### 󠀁[Nice and simple](https://wordpress.org/support/topic/nice-and-simple-277/)󠁿

 [mikejcandy](https://profiles.wordpress.org/mikejcandy/) 25 de agosto de 2021

Nice and simple plugin. Great replacement for the corrupt ProfilePress (previously
WP User Avatar).

![](https://secure.gravatar.com/avatar/198b6587d95d61dda2defa691f11afcc0ea7e23f2a014c4555a8023e9b4383c1?
s=60&d=retro&r=g)

### 󠀁[Refugee Seeking replacement](https://wordpress.org/support/topic/refugee-seeking-replacement/)󠁿

 [sxn31](https://profiles.wordpress.org/sxn31/) 12 de junio de 2021

As other reviewers are commenting, I'm here after being tricked by the authors of
a different avatar plugin. This is doing the job nicely.

![](https://secure.gravatar.com/avatar/8ff58d3b79f0f9e071f973f78b288e0b1bc995d9b3488bcf29d4e5cf3500f7e1?
s=60&d=retro&r=g)

### 󠀁[Excellent replacement for rival plugin](https://wordpress.org/support/topic/excellent-replacement-for-rival-plugin-gone-greedy/)󠁿

 [Lars](https://profiles.wordpress.org/thelogbookwebsite/) 31 de mayo de 2021

I was using rival plugin WP User Avatar (no "s") that just suddenly transformed 
into this 'ProfilePress' membership plugin adding a bunch of stuff I didn't need,
want or asked for. WP User Avatars (this plugin, with an "s") is light weight, functional
and does what it says it will do. Please keep it this way…

![](https://secure.gravatar.com/avatar/52a1331f63b7632c69f6ed530a1073a17d1b2f730559524627c316757395786a?
s=60&d=retro&r=g)

### 󠀁[Great Replacement for WP User Avatar](https://wordpress.org/support/topic/great-replacement-for-wp-user-avatar/)󠁿

 [Le Isaac](https://profiles.wordpress.org/marg3/) 30 de mayo de 2021

Glad I found this lightweight replacement for WP User Avatar (no "s"). That plugin
was recently changed extensively and rebranded as ProfilePress. I didn't want or
need all the stuff they added and am so happy that I found WP User Avatars (with
an "s"). It's such a good replacement and it does just what I need, which is to 
allow me to create custom avatars for my users and authors. Great work!

 [ Leer todas las 29 reseñas ](https://wordpress.org/support/plugin/wp-user-avatars/reviews/)

## Colaboradores y desarrolladores

“WP User Avatars” es un software de código abierto. Las siguientes personas han 
colaborado con este plugin.

Colaboradores

 *   [ John James Jacoby ](https://profiles.wordpress.org/johnjamesjacoby/)

“WP User Avatars” ha sido traducido a 10 idiomas. Gracias a [los traductores](https://translate.wordpress.org/projects/wp-plugins/wp-user-avatars/contributors)
por sus contribuciones.

[Traduce “WP User Avatars” a tu idioma.](https://translate.wordpress.org/projects/wp-plugins/wp-user-avatars)

### ¿Interesado en el desarrollo?

[Revisa el código](https://plugins.trac.wordpress.org/browser/wp-user-avatars/) ,
echa un vistazo al [repositorio SVN](https://plugins.svn.wordpress.org/wp-user-avatars/),
o suscríbete al [log de desarrollo](https://plugins.trac.wordpress.org/log/wp-user-avatars/)
por [RSS](https://plugins.trac.wordpress.org/log/wp-user-avatars/?limit=100&mode=stop_on_copy&format=rss).

## Registro de cambios

#### 2.1.0

 * Add a User Avatar Editor block and `[wp_user_avatars]` shortcode for normal pages.
 * Keep local avatars ahead of avatar providers that return early, including when
   their URLs match.
 * Preserve the primary profile save action when avatar controls are present.
 * Explain avatar display sizes and generated-size limits.
 * Document avatar alternative-text behavior for themes and plugins.

#### 2.0.1

 * Avoid warnings and deny avatar capability checks without a valid target user.
 * Use HTTPS for stored avatars hosted on the owning site’s HTTPS origin.
 * Preserve external avatar URLs and local resizing after an HTTPS migration.

#### 2.0.0

 * Require PHP 7.4 and WordPress 6.4 or newer.
 * Declare compatibility with WordPress 7.1.
 * Add WebP avatar uploads.
 * Prevent blocked Gravatar requests from leaking from the Comments screen.
 * Support remotely stored avatars, including WP Offload Media.
 * Support instant avatar uploads and previews.
 * Support avatar uploads, Media Library selection, and removal on bbPress profile
   screens.
 * Restrict Media Library selection to users who can browse it.
 * Display the avatar preview when public avatar display is disabled.
 * Improve uploads, translation loading, file deletion, automated testing, and contributor
   tooling.

#### [1.4.1] – 2021-05-29

 * Update author info
 * Add sponsor link

#### 1.4.0

 * Improved support for long file names

#### 1.3.0

 * Fix local avatars in comments

#### 1.2.0

 * BuddyPress profile styling support

#### 1.1.1

 * Rename functions.php to common.php

#### 1.1.0

 * Compatibility with future versions of WP User Profiles

#### 1.0.2

 * Fix bug with “Default Avatar” display introduced in 1.0.1

#### 1.0.1

 * Improved mu-plugins location support
 * Use WordPress 4.2+ functions & filters

#### 0.2.0

 * Support for User Profiles 0.2.0

#### 0.1.8

 * Hide “Profile Picture” section (WordPress 4.4)

#### 0.1.7

 * Improve capability mappings
 * Improve required file loading
 * Remove unused action hook

#### 0.1.6

 * Improve support for user dashboard

#### 0.1.5

 * Support for WP User Profiles 0.1.7

#### 0.1.4

 * Bump assets & update readme’s & metadata

#### 0.1.3

 * Improve compatibility with WP User Profiles

#### 0.1.2

 * Improve avatar styling

#### 0.1.1

 * Retina support for user profiles

#### 0.1.0

 * Initial release

## Meta

 *  Versión **2.1.0**
 *  Última actualización **hace 1 semana**
 *  Instalaciones activas **20.000+**
 *  Versión de WordPress ** 6.4 o superior **
 *  Testeado hasta **7.1.3**
 *  Versión de PHP ** 7.4 o superior **
 *  Idiomas
 * [Arabic](https://ar.wordpress.org/plugins/wp-user-avatars/), [Chinese (Taiwan)](https://tw.wordpress.org/plugins/wp-user-avatars/),
   [Dutch](https://nl.wordpress.org/plugins/wp-user-avatars/), [Dutch (Belgium)](https://nl-be.wordpress.org/plugins/wp-user-avatars/),
   [English (UK)](https://en-gb.wordpress.org/plugins/wp-user-avatars/), [English (US)](https://wordpress.org/plugins/wp-user-avatars/),
   [German](https://de.wordpress.org/plugins/wp-user-avatars/), [Japanese](https://ja.wordpress.org/plugins/wp-user-avatars/),
   [Norwegian (Bokmål)](https://nb.wordpress.org/plugins/wp-user-avatars/), [Swedish](https://sv.wordpress.org/plugins/wp-user-avatars/),
   y [Ukrainian](https://uk.wordpress.org/plugins/wp-user-avatars/).
 *  [Traducir a tu idioma](https://translate.wordpress.org/projects/wp-plugins/wp-user-avatars)
 * Etiquetas:
 * [avatar](https://es-ar.wordpress.org/plugins/tags/avatar/)[local](https://es-ar.wordpress.org/plugins/tags/local/)
   [media](https://es-ar.wordpress.org/plugins/tags/media/)[profile](https://es-ar.wordpress.org/plugins/tags/profile/)
   [user](https://es-ar.wordpress.org/plugins/tags/user/)
 *  [Vista avanzada](https://es-ar.wordpress.org/plugins/wp-user-avatars/advanced/)

## Valoraciones

 4.5 de 5 estrellas.

 *  [  24 valoraciones de 5 estrellas     ](https://wordpress.org/support/plugin/wp-user-avatars/reviews/?filter=5)
 *  [  0 valoraciones de 4 estrellas     ](https://wordpress.org/support/plugin/wp-user-avatars/reviews/?filter=4)
 *  [  2 valoraciones de 3 estrellas     ](https://wordpress.org/support/plugin/wp-user-avatars/reviews/?filter=3)
 *  [  2 valoraciones de 2 estrellas     ](https://wordpress.org/support/plugin/wp-user-avatars/reviews/?filter=2)
 *  [  1 valoración de 1 estrellas     ](https://wordpress.org/support/plugin/wp-user-avatars/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/wp-user-avatars/reviews/#new-post)

[Ver todas las reseñas](https://wordpress.org/support/plugin/wp-user-avatars/reviews/)

## Colaboradores

 *   [ John James Jacoby ](https://profiles.wordpress.org/johnjamesjacoby/)

## Soporte

Problemas resueltos en los últimos dos meses:

     0 de 1

 [Ver el foro de asistencia](https://wordpress.org/support/plugin/wp-user-avatars/)

## Donar

¿Te gustaría apoyar el progreso de este plugin?

 [ Doná a este plugin ](https://buy.stripe.com/7sI3cd2tK1Cy2lydQR)