Bottts

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

Usage#

HTTP-API (recommended)#

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

https://avatars.dicebear.com/api/bottts/:seed.svg

See the HTTP API documentation for more information.

Examples#

previewurl
https://avatars.dicebear.com/api/bottts/example.svg
https://avatars.dicebear.com/api/bottts/example.svg?colors[]=cyan
https://avatars.dicebear.com/api/bottts/example.svg?colors[]=cyan&primaryColorLevel=200

NPM#

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');

Options#

namealiastypedefaultdescription
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