Simple Local Avatars

Add an avatar upload field to user profiles. Generate requested sizes on demand, just like Gravatar.

Adds an avatar upload field to user profiles if the current user has media permissions. Generates requested sizes on demand just like Gravatar! Simple and lightweight.

Just edit a user profile, and scroll down to the new “Avatar” field. The plug-in will take care of cropping and sizing!

  1. Stores avatars in the “uploads” folder where all of your other media is kept
  2. Has a simple, native interface
  3. Fully supports Gravatar and default avatars if no local avatar is set for the user – but also allows you turn off Gravatar
  4. Generates the requested avatar size on demand (and stores the new size for efficiency), so it looks great, just like Gravatar!
  5. Let’s you decide whether lower privilege users (subscribers, contributors) can upload their own avatar
  6. Enables rating of local avatars, just like Gravatar

Avatar upload field on a user profile page

  • Rating
  • Requires 4.6+
  • Downloads 533,803
  • Updated 2019-05-07
  1. This plugin, when used causes users to not show up in my user list section.

  2. Hello, I am using WP 3 multisite and Simple Avatar works in my main blog. However my secondary blog can upload avatar but it shows a wrong upload path. In my main blog my path is:

    And my secondary blog path is:

    I have been looking for an option in the db to modify this path but I didn’t find it

    Thank you.

  3. Hello,

    I really like the simplicity of this plugin. There is just one pesky bug which prevents the avatars from showing up on sites where the home page is not /wordpress (i.e. if the home_url is different from the site_url).

    Line 95 reads:

    $local_avatars[$size] = site_url( $local_avatars[$size] );

    just change this for:

    $local_avatars[$size] = home_url( $local_avatars[$size] );

    And the plugin will be fixed for me and probably a lot of users!

  4. Uploading an image resulted in a 500 server error..

  5. Fantastic plugin!
    Another annoying bug: upload is not protected against uncompatible files (bmp..)

    • Actually it does. But it accepts jpg, gif, png, bmp, and tif images!

  6. Hello Jake,

    Currently Simple Local Avatars defaults to a avatar or the mystery man avatar (which is actually also a avatar) if no local avatar is selected.

    As privacy is sort of an issue on one of my (personal) sites, but people (read subscribers) still would like to have a stylish, but local avatar. I wondered if it would be possible to strip down any Gravatar functionality from this plugin/WordPress making it default to a local hosted mystery man avatar instead.

    Of course, if you think this would require much more work, would it be possible to send me a quotation perhaps?

    Best regards,

    Cor van Noorloos

    • Yes, it’s very possible using the gravatar hooks in WordPress.

  7. Hey, I have changed my permalink settings and the plugin don’t work for avatar admin ??


    • Permalink settings have no bearing on this plug-in.

  8. Thanks for this simple plugin.
    One question – how do I change the permission to allow everyone to upload an avatar (I am sure it is ABC, but I am new to all this).


    • The media permissions setting is under Settings > Discussion

    • I don’t see it. Maybe its not longer in the newest version of WordPress.

      • You should see it in the latest versions. It’s on the add user / edit user / edit profile screens in the admin dashboard.

  9. Additional question,

    I created a custom login page, rather a plugin I am using did, how do I add in the option of adding/changing an avatar on this new custom page?


  10. Hey! Great work, thanks for this simple and easy plugin.

    Just one question: any chance to increase the size of saved avatars? I can’t find the line of code which is responsible for the 96px limitation.

    • The avatar sizes are generated dynamically when they’re requested, including larger sizes.

      • Indeed. Awesome, thanks a lot!

      • Size when requested, how does this work? I want to use the original size of the image, how is that done? How do I call the original image to show on a page?

        • Er, you don’t. You’d have to get the raw user meta with the avatar, and pull it apart. I believe if you specify a huge size, however, it will only show you “up to” the full size of the avatar.

  11. Hi, I am using your simple local avatars plugin and like it – but need the avatars to be called securely with SSL. Is there a way to do that in the dashboard, or do I need to look at the php file? I have changed the general WP settings to the secure prefixes, but the SLA plugin images are leaving breaking the nice “This site is secure.” Thanks!

    • Hmm. They should use whatever URL WordPress is using. Did you upload them after changing your WordPress settings to “secure”?

      • no, before..

      • should I have? Will that make a difference going

        • I uninstalled, deleted the icons, and
          reinstalled/reuploaded. All is good again. Thanks.

  12. Genial Plugin, trabaja para mi :D

  13. Thanks Jake for such a wonderful, simple and easy-to-use plugin.

    My theme allows users to edit their profile from the font-end and this plugin works perfectly with this capability!

    Thanks for your hard work!!! … can’t wait 2 try out your other plugins.

    • Did you manage to make it upload avatars from the front end?

  14. Hi,

    I really like this plug-in but i have some trouble when I’m uploading a avatar from the front end. it’s possibile ?

  15. Hi.
    This plugin was work fine for me, but I move my site to other provider.
    And now it doesn’t :-)
    I use WP 3.1.2 and this plugin. When I try to upload avatar to profile I’v got an error:

    $_POST[post_category] = Array

    Warning: Cannot modify header information – headers already sent by (output started at /mounted-storage/home123c/sub006/sc69003-GSRO/ in /mounted-storage/home123c/sub006/sc69003-GSRO/ on line 897

    Could U help to me ? Any ideas …

  16. Thanks a lot for the plugin, but i have 1 question: how to limit max filesize of uploading avatars? I want to set up 500 kb for example.
    Sorry for my poor english :)

  17. Can anyone explain how one goes about setting up front end uploading?

    • It’s enabled with front end profile plug-ins / implementations that reuse the administrative profile form.

      • Could you elaborate on this a bit? I’ve got a frontend page where users can log in and their meta (and custom meta) is displayed in input fields, and they can change these fields and save their changes. I copy/pasted the bit of your plugin that generates the upload button onto my frontend page and it’s saying “The site is experiencing technical difficulties”.

        I’m assuming there’s some dependency that the plugin relies on that isn’t provided on frontend pages. This plugin would be great for my purposes if I could get it working on a frontend page.


  18. Can you help me allow people to upload 3 to 5 profile images but only have the first one show as a replacement Gravitar?

    Love your plugin!!!



    • Someone could… but I’m keeping this plug-in simple. Feel free to request our services, of course!

  19. GREAT plugin! just a couple of queries… is it possible to specify a directory to upload images to? ie uploads/author-avatars

    and, you noted above that the image size is dynamically generated… but I still don’t understand how this works? I need to change my thumbnail output (and filename) to 140px size…. any chance you could help me change that?

    • Theoretically, an upload folder could be specified. But I personally don’t like the idea of cluttering the uploads folder with new folders; this also makes it trickier to support implementations where uploads is hosted elsewhere.

      To request a 140px size, where your theme calls “get_avatar”, you need to specify “140” as the second parameter (the size).

      Just like gravatar, if that image size hasn’t been created yet, it will be created (and saved) on the fly when called the first time.

  20. Moin,

    danke für das Plugin, allerdings wie kann ich die Größe der avatare ändern?
    60×60 ist atm bei mir, das finde ich etwas zu klein

Leave a Comment

Finely crafted websites & tools that make the web better.