Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


E0 N1 J2 03 Y4 AA5 PP7 ZZ11

Did you never wanted to serve letter avatars from a fast CDN to take advantage of low network latency, efficient caching strategies and be technology independent?

Using CSS for a basic letter avatar is not always the right solution.

This repository contains pre-generated PNG and SVG images for all single and two letters avatars, including variants with 19 background colors. That's 25,688 avatar images ready to be served from edge nodes and cached efficiently.

How to use

You can import any avatar image as follows:

<img src="" />
<img src="" />

Images must use as base URL. Each image is named using one or two uppercase letters followed by a number that ranges between 0 and 18 included. The number depicts one of the 19 background color variants that you can use.

Generating default users avatar

We recommend generating a URL per user when an account is created and to save the generated URL next to other user data.

To create the user avatar URL you need to proceed in 3 steps:

  1. Extract the single or 2 letters from the user display name, transform them to uppercase and append them to the base URL;
  2. Hash the user display name or email to get a number, apply modulo 19 and append the value to the URL obtained in 1;
  3. Append the image type as extension (.png or .svg supported).

Ideally, when a user updates his display name or email you should regenerates his/her default avatar URL.

Rounded corners

Do you want rounded corners or a disk as a background image? let's use CSS:

<img src="" style="border-radius: 8px" />
<img src="" style="border-radius: 50%" />