Skip to content
A super easy AJAX file uploading app to easily store avatars for user profiles.
JavaScript CSS Python Makefile Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


A super easy AJAX file uploading app to easily store avatars for user profiles. django-easy-avatar is currently being used in production by Noob Media LLC for


django-easy-avatar uses jQuery for ajax file uploading and validation. this plugin also uses Pillow for image manipulation to resize images @ 100px X 100px while maintaining the correct aspect ratio. It also uses standard HTML5 uploading progress to display uploading status.

If you need to override the custom styling of the Avatar upload buttons or image etc... just use CSS.

If you feel this plugin needs additional features feel free to contact me with your suggestions or fork the project.

== Installation Instructions ==

  1. pip install django-easy-avatar

  2. add easy_avatar to your installed apps

  3. add the below paths to your file (make sure you point to the right locations


FILE_SAVE_PATH = "/root/path/to/your/static/avatars" ## must give apache or whatever webserver you're using write access to this directory

FILE_URL_PATH = "" ## your url where the uploaded image can be handled by your server

  1. Add 'django.core.context_processors.request' to your TEMPLATE_CONTEXT_PROCESSORS in your file. (example) TEMPLATE_CONTEXT_PROCESSORS = ( ... 'django.core.context_processors.request', ... )

  2. add (r'^avatar/', include('easy_avatar.urls')), to your file

  3. in the template where you plan on using django-easy-avatar add {% load avatar_tags %} to the top of the template, also add jQuery library.

  4. to place the form in the page add the below (example) {% if request.user.is_authenticated and == %} {% upload_form %} {% else %} {{ avatar.image_url }} /* wrap this in an image tag */ {% endif %}

If you have any troubles with this setup you're most likely running into permissions problem when your app tries to save the uploaded images.

see this link for setting permissions to allow apache to create directories and files.

**** there is a known problem with trying to add an easy_avatar via the admin console, I am looking into this ****

You can’t perform that action at this time.