UI Avatars Generate avatars with initials from names. UI Avatars has a simple-to-use API with no limiting or login. No usage tracking and no information is stored. The final images are cached, but nothing else. Just write name or surname, or both. +28,140,000 Daily Requests 2.8931 ms Avg. Processing Time

Usage

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

Generate a avatar with default settings, for user "John Doe".

https://ui-avatars.com/api/? name = John+Doe

Generate a blue avatar

https://ui-avatars.com/api/? background = 0D8ABC & color = fff

Settings

Image Size ( size )

Avatar image size in pixels. Between: 16 and 512. Default: 64

https://ui-avatars.com/api/? size = 128

Font Size ( font-size )

Font size in percentage of size . Between 0.1 and 1. Default: 0.5

https://ui-avatars.com/api/? font-size = 0.33

Initial Characters ( length )

Length of the generated initials. Default: 2

https://ui-avatars.com/api/? length = 1

Name ( name )

The name used to generate initials. You can specify the initials yourself as well. Default: John Doe

https://ui-avatars.com/api/? name = Elon+Musk

Rounded Image ( rounded )

Boolean specifying if the returned image should be a circle. Default: false

https://ui-avatars.com/api/? rounded = true

Bold ( bold )

Boolean specifying if the returned letters should use a bold font. Default: false

https://ui-avatars.com/api/? bold = true

Background Color ( background )

Hex color for the image background, without the hash (#). Default: f0e9e9

https://ui-avatars.com/api/? background = a0a0a0

Font Color ( color )

Hex color for the font, without the hash (#). Default: 8b5d5d

https://ui-avatars.com/api/? color = ff0000

Uppercase ( uppercase )

Decide if the API should uppercase the name/initials. Default: true

https://ui-avatars.com/api/? uppercase = false & name = different+Case

Format ( format )

Decide if the API should return SVG or PNG. Default: svg if the Accept header includes image/svg+xml , png otherwise

https://ui-avatars.com/api/? format = svg

All settings above can be mixed together as you desire.

With gravatar or similar

A good use-case would be using it as a fallback for Gravatar. Example:

https://www.gravatar.com/avatar/ EMAIL_MD5 ? d = https%3A%2F%2Fui-avatars.com%2Fapi%2F/Lasse+Rafn/128

Because of limitations in Gravatar, we must pass in the parameters as sub-directories, instead of query-parameters. You should also consider urlencoding the name, in case it contains special characters. It's a limitation by Gravatar, not UI Avatars.

name

size

background

color

length

font-size

rounded

uppercase

bold

format

Retina

The order is as follows:

I recommend using 1.5x or 2x sizes for your avatars, but keeping the img tag the original size, to ensure crisp avatars on high DPI screens.

Language/Script support

I have added support for some unicode scripts/languages that are not supported by the typical fonts. Current support:

Arabic

Armenian

Bengali

Georgian

Hebrew

Chinese

Japanese

Mongolian

Thai

Tibetan

Wordpress plugin

It has Wordpress plugin! If you have a Wordpress site, you can use the Wordpress plugin, which is also free.

Privacy and Monitoring

No data is being stored on our serveres. Monitoring & logging is entirely disabled.