Avatador

Easily generate avatars and identicons.

Simple-to-use API with no limit or login. No data is stored, no monitoring, and no logging.

All requests return an image stream to be used directly in a <img/> tag.

JS MS RS MG DS MR MS MH MM JJ JS MS RS MG DS MR MS MH MM JJ
An avatar based on the name "James Smith".
https://avatador.io/av/?name=James+Smith
Example Identicon
A black identicon based on the name "Maria Garcia"
https://avatador.io/id/?background=000000&name=Maria+Garcia
Example Identicon

Options

Name (name)

Name, title, phrase, or pretty much any other text to turn into initials.

If not provided will show an empty icon.

https://avatador.io/av/?name=David+Doe
Color (background)

Background color in hex format, without "#", i.e. "D6D6D6".

If not provided will show a random color. Random colors are cached so the same name will always have the same color background.

Supports transparency; #RGB #RGBA #RRGGBB #RRGGBBAA

https://avatador.io/av/?background=D6F8D5
Size (height width)

Image size in pixels. Default: 500

Both values are optional, if only one is provided they are set equal.

https://avatador.io/av/?height=500
https://avatador.io/av/?width=500
https://avatador.io/av/?height=500&width=500
Font (color font-size font-family bold)

Font styling options.

color set the font color in hex format, without "#". Default: FFFFFF / white.

font-size font size in pixels. If nothing provided it will auto calculate.

font-family set the font family.

bold if set to true will bold the text.

https://avatador.io/av/?name=John&color=FFFFFF
https://avatador.io/av/?name=John&font-size=250
https://avatador.io/av/?name=John&font-family=Montoserrat
https://avatador.io/av/?name=John&bold=true
Capatalize (caps)

How do you want the text to be capatalized?

1 all uppercase

2 all lowercase

3 leave as provided

https://avatador.io/av/?name=John&caps=1
Rounding (is_rounded rounded)

Prefer with rounded edges, or fully round?

is_rounded set to true to get a fully rounded image.

rounded provide a value in pixels if you want to customize the rounding.

https://avatador.io/av/?is_rounded=true
https://avatador.io/av/?rounded=10
Format

By default all images are returned as SVG.

If you prefer PNG, include png before the parameters.

PNG only supports identicons, and no rounding.

https://avatador.io/id/png?background=6E9C40
https://avatador.io/id/svg?background=6E9C40

Get Creating!

Name:
=
Color:
=
Size:
=
=
Font:
=
=
=
Capatalize
=


Rounding
=
=
Avatar request: https://avatador.io/av/?
Avatador URL Builder
Identicon request: https://avatador.io/id/?
Identicon URL Builder

Made by Ruud.

Code on GitHub