Avataaars

This avatar style is a remix of: Avataaars by Pablo Stanley, licensed under Free for personal and commercial use .

LICENSE

While our code is MIT licensed, the design of this avatar style is licensed under Free for personal and commercial use. See details for more information.

Open in Playground

Usage

Use this URL to request this avatar style via our HTTP API.

https://api.dicebear.com/9.x/avataaars/svg

You can use the URL directly as image source.

See HTTP-API docs for more information.

First install the required packages via npm:

npm install @dicebear/core @dicebear/collection --save

Then you can create this avatar as follows:

import { createAvatar } from '@dicebear/core';
import { avataaars } from '@dicebear/collection';

const avatar = createAvatar(avataaars, {
  // ... options
});

const svg = avatar.toString();

See JS-Library docs for more information.

First install the CLI package via npm:

npm install --global dicebear

Then you can create this avatar as follows:

dicebear avataaars

See CLI docs for more information.

Options

seed

Type string

The seed determines the initial value for the built-in PRNG. With the PRNG you can create the same avatar over and over again based.

Felix

Aneka

https://api.dicebear.com/9.x/avataaars/svg?seed=Felix

createAvatar(avataaars, {
  seed: "Felix"
});

dicebear avataaars --seed "Felix"

flip

Type boolean

false

true

false

https://api.dicebear.com/9.x/avataaars/svg?flip=false

createAvatar(avataaars, {
  flip: false
});

dicebear avataaars --flip false

rotate

Type integerMinimum 0Maximum 360

0

90

180

270

0

https://api.dicebear.com/9.x/avataaars/svg?rotate=0

createAvatar(avataaars, {
  rotate: 0
});

dicebear avataaars --rotate 0

scale

Type integerMinimum 0Maximum 200

50

100

200

100

https://api.dicebear.com/9.x/avataaars/svg?scale=50

createAvatar(avataaars, {
  scale: 50
});

dicebear avataaars --scale 50

radius

Type integerMinimum 0Maximum 50

0

10

20

30

40

50

0

https://api.dicebear.com/9.x/avataaars/svg?radius=0

createAvatar(avataaars, {
  radius: 0
});

dicebear avataaars --radius 0

size

Type integerMinimum 1

32

48

64

80

96

https://api.dicebear.com/9.x/avataaars/svg?size=32

createAvatar(avataaars, {
  size: 32
});

dicebear avataaars --size 32

backgroundColor

Type arrayItem Pattern ^(transparent|[a-fA-F0-9]{6})$

b6e3f4

c0aede

d1d4f9

ffd5dc

ffdfbf

65c9ff

https://api.dicebear.com/9.x/avataaars/svg?backgroundColor=b6e3f4,c0aede,d1d4f9

createAvatar(avataaars, {
  backgroundColor: ["b6e3f4","c0aede","d1d4f9"]
});

dicebear avataaars --backgroundColor "b6e3f4" "c0aede" "d1d4f9"

backgroundType

Type array

gradientLinear

solid

https://api.dicebear.com/9.x/avataaars/svg?backgroundType=gradientLinear,solid

createAvatar(avataaars, {
  backgroundType: ["gradientLinear","solid"]
});

dicebear avataaars --backgroundType "gradientLinear" "solid"

backgroundRotation

Type array

Specify an array of two numbers for this option. The PRNG will generate a number between the two values, which will be used as the rotation degree. The rotation is only visible if backgroundType is set to ['gradientLinear'].

0

360

https://api.dicebear.com/9.x/avataaars/svg?backgroundRotation=0,360

createAvatar(avataaars, {
  backgroundRotation: [0,360]
});

dicebear avataaars --backgroundRotation 0 360

translateX

Type integerMinimum -100Maximum 100

-50

-25

0

25

50

0

https://api.dicebear.com/9.x/avataaars/svg?translateX=-50

createAvatar(avataaars, {
  translateX: -50
});

dicebear avataaars --translateX -50

translateY

Type integerMinimum -100Maximum 100

-50

-25

0

25

50

0

https://api.dicebear.com/9.x/avataaars/svg?translateY=-50

createAvatar(avataaars, {
  translateY: -50
});

dicebear avataaars --translateY -50

clip

Type boolean

true

https://api.dicebear.com/9.x/avataaars/svg?clip=true

createAvatar(avataaars, {
  clip: true
});

dicebear avataaars --clip true

randomizeIds

Type boolean

This option randomize the IDs in the generated SVG / XML. This can be useful for example if the avatars are included directly in the HTML and you want to avoid ID collisions.

false

https://api.dicebear.com/9.x/avataaars/svg?randomizeIds=false

createAvatar(avataaars, {
  randomizeIds: false
});

dicebear avataaars --randomizeIds false

accessories

Type array

eyepatch

kurt

prescription01

prescription02

round

sunglasses

wayfarers

eyepatch

kurt

prescription01

prescription02

round

sunglasses

wayfarers

https://api.dicebear.com/9.x/avataaars/svg?accessories=eyepatch,kurt,prescription01

createAvatar(avataaars, {
  accessories: ["eyepatch","kurt","prescription01"]
});

dicebear avataaars --accessories "eyepatch" "kurt" "prescription01"

accessoriesColor

Type arrayItem Pattern ^(transparent|[a-fA-F0-9]{6})$

3c4f5c

65c9ff

262e33

5199e4

25557c

929598

a7ffc4

b1e2ff

e6e6e6

ff5c5c

ff488e

ffafb9

ffdeb5

ffffb1

ffffff

https://api.dicebear.com/9.x/avataaars/svg?accessoriesColor=3c4f5c,65c9ff,262e33

createAvatar(avataaars, {
  accessoriesColor: ["3c4f5c","65c9ff","262e33"]
});

dicebear avataaars --accessoriesColor "3c4f5c" "65c9ff" "262e33"

accessoriesProbability

Type integerMinimum 0Maximum 100

0

100

10

https://api.dicebear.com/9.x/avataaars/svg?accessoriesProbability=0

createAvatar(avataaars, {
  accessoriesProbability: 0
});

dicebear avataaars --accessoriesProbability 0

base

Type array

default

https://api.dicebear.com/9.x/avataaars/svg?base=default

createAvatar(avataaars, {
  base: ["default"]
});

dicebear avataaars --base "default"

clothesColor

Type arrayItem Pattern ^(transparent|[a-fA-F0-9]{6})$

3c4f5c

65c9ff

262e33

5199e4

25557c

929598

a7ffc4

b1e2ff

e6e6e6

ff5c5c

ff488e

ffafb9

ffffb1

ffffff

https://api.dicebear.com/9.x/avataaars/svg?clothesColor=3c4f5c,65c9ff,262e33

createAvatar(avataaars, {
  clothesColor: ["3c4f5c","65c9ff","262e33"]
});

dicebear avataaars --clothesColor "3c4f5c" "65c9ff" "262e33"

clothing

Type array

blazerAndShirt

blazerAndSweater

collarAndSweater

graphicShirt

hoodie

overall

shirtCrewNeck

shirtScoopNeck

shirtVNeck

blazerAndShirt

blazerAndSweater

collarAndSweater

graphicShirt

hoodie

overall

shirtCrewNeck

shirtScoopNeck

shirtVNeck

https://api.dicebear.com/9.x/avataaars/svg?clothing=blazerAndShirt,blazerAndSweater,collarAndSweater

createAvatar(avataaars, {
  clothing: ["blazerAndShirt","blazerAndSweater","collarAndSweater"]
});

dicebear avataaars --clothing "blazerAndShirt" "blazerAndSweater" "collarAndSweater"

clothingGraphic

Type array

bat

bear

cumbia

deer

diamond

hola

pizza

resist

skull

skullOutline

bat

bear

cumbia

deer

diamond

hola

pizza

resist

skull

skullOutline

https://api.dicebear.com/9.x/avataaars/svg?clothingGraphic=bat,bear,cumbia

createAvatar(avataaars, {
  clothingGraphic: ["bat","bear","cumbia"]
});

dicebear avataaars --clothingGraphic "bat" "bear" "cumbia"

eyebrows

Type array

angry

angryNatural

default

defaultNatural

flatNatural

frownNatural

raisedExcited

raisedExcitedNatural

sadConcerned

sadConcernedNatural

unibrowNatural

upDown

upDownNatural

angry

angryNatural

default

defaultNatural

flatNatural

frownNatural

raisedExcited

raisedExcitedNatural

sadConcerned

sadConcernedNatural

unibrowNatural

upDown

upDownNatural

https://api.dicebear.com/9.x/avataaars/svg?eyebrows=angry,angryNatural,default

createAvatar(avataaars, {
  eyebrows: ["angry","angryNatural","default"]
});

dicebear avataaars --eyebrows "angry" "angryNatural" "default"

eyes

Type array

closed

cry

default

eyeRoll

happy

hearts

side

squint

surprised

wink

winkWacky

xDizzy

closed

cry

default

eyeRoll

happy

hearts

side

squint

surprised

wink

winkWacky

xDizzy

https://api.dicebear.com/9.x/avataaars/svg?eyes=closed,cry,default

createAvatar(avataaars, {
  eyes: ["closed","cry","default"]
});

dicebear avataaars --eyes "closed" "cry" "default"

facialHair

Type array

beardLight

beardMajestic

beardMedium

moustacheFancy

moustacheMagnum

beardLight

beardMajestic

beardMedium

moustacheFancy

moustacheMagnum

https://api.dicebear.com/9.x/avataaars/svg?facialHair=beardLight,beardMajestic,beardMedium

createAvatar(avataaars, {
  facialHair: ["beardLight","beardMajestic","beardMedium"]
});

dicebear avataaars --facialHair "beardLight" "beardMajestic" "beardMedium"

facialHairColor

Type arrayItem Pattern ^(transparent|[a-fA-F0-9]{6})$

2c1b18

4a312c

724133

a55728

b58143

c93305

d6b370

e8e1e1

ecdcbf

f59797

https://api.dicebear.com/9.x/avataaars/svg?facialHairColor=2c1b18,4a312c,724133

createAvatar(avataaars, {
  facialHairColor: ["2c1b18","4a312c","724133"]
});

dicebear avataaars --facialHairColor "2c1b18" "4a312c" "724133"

facialHairProbability

Type integerMinimum 0Maximum 100

0

100

10

https://api.dicebear.com/9.x/avataaars/svg?facialHairProbability=0

createAvatar(avataaars, {
  facialHairProbability: 0
});

dicebear avataaars --facialHairProbability 0

hairColor

Type arrayItem Pattern ^(transparent|[a-fA-F0-9]{6})$

2c1b18

4a312c

724133

a55728

b58143

c93305

d6b370

e8e1e1

ecdcbf

f59797

https://api.dicebear.com/9.x/avataaars/svg?hairColor=2c1b18,4a312c,724133

createAvatar(avataaars, {
  hairColor: ["2c1b18","4a312c","724133"]
});

dicebear avataaars --hairColor "2c1b18" "4a312c" "724133"

hatColor

Type arrayItem Pattern ^(transparent|[a-fA-F0-9]{6})$

3c4f5c

65c9ff

262e33

5199e4

25557c

929598

a7ffc4

b1e2ff

e6e6e6

ff5c5c

ff488e

ffafb9

ffdeb5

ffffb1

ffffff

https://api.dicebear.com/9.x/avataaars/svg?hatColor=3c4f5c,65c9ff,262e33

createAvatar(avataaars, {
  hatColor: ["3c4f5c","65c9ff","262e33"]
});

dicebear avataaars --hatColor "3c4f5c" "65c9ff" "262e33"

mouth

Type array

concerned

default

disbelief

eating

grimace

sad

screamOpen

serious

smile

tongue

twinkle

vomit

concerned

default

disbelief

eating

grimace

sad

screamOpen

serious

smile

tongue

twinkle

vomit

https://api.dicebear.com/9.x/avataaars/svg?mouth=concerned,default,disbelief

createAvatar(avataaars, {
  mouth: ["concerned","default","disbelief"]
});

dicebear avataaars --mouth "concerned" "default" "disbelief"

nose

Type array

default

https://api.dicebear.com/9.x/avataaars/svg?nose=default

createAvatar(avataaars, {
  nose: ["default"]
});

dicebear avataaars --nose "default"

skinColor

Type arrayItem Pattern ^(transparent|[a-fA-F0-9]{6})$

614335

ae5d29

d08b5b

edb98a

f8d25c

fd9841

ffdbb4

https://api.dicebear.com/9.x/avataaars/svg?skinColor=614335,ae5d29,d08b5b

createAvatar(avataaars, {
  skinColor: ["614335","ae5d29","d08b5b"]
});

dicebear avataaars --skinColor "614335" "ae5d29" "d08b5b"

style

Type array

circle

default

https://api.dicebear.com/9.x/avataaars/svg?style=circle,default

createAvatar(avataaars, {
  style: ["circle","default"]
});

dicebear avataaars --style "circle" "default"

top

Type array

bigHair

bob

bun

curly

curvy

dreads

dreads01

dreads02

frida

frizzle

fro

froBand

hat

hijab

longButNotTooLong

miaWallace

shaggy

shaggyMullet

shavedSides

shortCurly

shortFlat

shortRound

shortWaved

sides

straight01

straight02

straightAndStrand

theCaesar

theCaesarAndSidePart

turban

winterHat1

winterHat02

winterHat03

winterHat04

bigHair

bob

bun

curly

curvy

dreads

dreads01

dreads02

frida

frizzle

fro

froBand

hat

hijab

longButNotTooLong

miaWallace

shaggy

shaggyMullet

shavedSides

shortCurly

shortFlat

shortRound

shortWaved

sides

straight01

straight02

straightAndStrand

theCaesar

theCaesarAndSidePart

turban

winterHat1

winterHat02

winterHat03

winterHat04

https://api.dicebear.com/9.x/avataaars/svg?top=bigHair,bob,bun

createAvatar(avataaars, {
  top: ["bigHair","bob","bun"]
});

dicebear avataaars --top "bigHair" "bob" "bun"

topProbability

Type integerMinimum 0Maximum 100

0

100

https://api.dicebear.com/9.x/avataaars/svg?topProbability=0

createAvatar(avataaars, {
  topProbability: 0
});

dicebear avataaars --topProbability 0

Details

Naming
Collection Import	import { avataaars } from '@dicebear/collection';
Package Import	import * as style from '@dicebear/avataaars';
CLI	dicebear avataaars
HTTP-API	https://api.dicebear.com/9.x/avataaars/svg
JSON Schema	https://api.dicebear.com/9.x/avataaars/schema.json

Source
Title	Avataaars
Creator	Pablo Stanley
Website	https://twitter.com/pablostanley
License	Free for personal and commercial use
Source	https://avataaars.com/

Avataaars ​

Usage ​

Options ​

seed

flip

rotate

scale

radius

size

backgroundColor

backgroundType

backgroundRotation

translateX

translateY

clip

randomizeIds

accessories

accessoriesColor

accessoriesProbability

base

clothesColor

clothing

clothingGraphic

eyebrows

eyes

facialHair

facialHairColor

facialHairProbability

hairColor

hatColor

mouth

nose

skinColor

style

top

topProbability

Details ​

Avataaars

Usage

Options

Details