Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Javascript Picker for API
JavaScript CoffeeScript
Latest commit 523d37b @vdemedes vdemedes updated library
Failed to load latest commit information.
dist updated library
lib updated library
src updated library
test updated library
vendor removed jQuery as a dependency
.gitignore added gitignore
Gruntfile.js updated library updated library
grunt.js update
package.json updated library uploader for browsers

Use this library to upload images to and get URLs to them. No server-side configuration required.

Getting Started

First, go to and obtain your public authorization token for use on client side.

Include in your web page(2.6kb) and configure it:

<script src=""></script>
var client = new AvatarsIO('Your public token'); // obtain at

    var uploader = client.create('#avatar'); // selector for input[type="file"] field, here #avatar, for example
    uploader.setAllowedExtensions(['png', 'jpg']); // optional, defaults to png, gif, jpg, jpeg
    uploader.on('complete', function(url){
        alert(url); // for example,

Next, set up file field with #avatar id (for example):

<div> <!-- surround it with some container element -->
    <input type="file" id="avatar">


Library emits such events as: init, start, complete. You can add listeners to these using on method:

uploader.on('init', function(){
    // instance of uploader initialized

uploader.on('start', function(){
    // fires when new avatar starts uploading

uploader.on('complete', function(url){
    // fires when avatar finished uploading


© Chute Corporation.

Something went wrong with that request. Please try again.