Designed by Pablo Stanley. The Sketch library can be found on


HTTP-API (recommended)#

Our free HTTP-API is the easiest way to use this avatar style. Just use the following URL as image source.

See the HTTP API documentation for more information.




Install the Avatars and this avatar style with the following command.

npm install --save @dicebear/avatars @dicebear/avatars-bottts-sprites

Now you are ready to create your first Avatar.

import Avatars from '@dicebear/avatars';
import sprites from '@dicebear/avatars-bottts-sprites';
let avatars = new Avatars(sprites());
let svg = avatars.create('custom-seed');


radiusrnumber0Avatar border radius
dataUriboolfalseReturn avatar as data uri instead of XML
Not supported by the HTTP API
widthwnumbernullFixed width
heighthnumbernullFixed height
marginmnumber0Avatar margin in percent
HTTP-API limitation Max value 25
backgroundbstringnullAny valid color identifier
HTTP-API limitation Only hex (3-digit, 6-digit and 8-digit) values are allowed. Use url encoded hash: %23.
colorsarray of stringsnullPossible values: amber, blue, blueGrey, brown, cyan, deepOrange, deepPurple, green, grey, indigo, lightBlue, lightGreen, lime, orange, pink, purple, red, teal, yellow
primaryColorLevelnumber600Possible values: 50, 100, 200, 300, 400, 500, 600, 700, 800, 900
secondaryColorLevelnumber400Possible values: 50, 100, 200, 300, 400, 500, 600, 700, 800, 900
colorfulbooleanfalseAssigns sides and top a random secondary color
mouthChancenumber100Probability in percent avatar will have a mouth
sidesChancenumber100Probability in percent avatar will have side elements
textureChancenumber50Probability in percent avatar will have texture
topChancenumber100Probability in percent avatar will have a top element