Identicon

Identicon by DiceBear, licensed under CC0 1.0 .

LICENSE

While our code is MIT licensed, the design of this avatar style is licensed under CC0 1.0. 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/identicon/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 { identicon } from '@dicebear/collection';

const avatar = createAvatar(identicon, {
  // ... 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 identicon

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/identicon/svg?seed=Felix

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

dicebear identicon --seed "Felix"

flip

Type boolean

false

true

false

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

createAvatar(identicon, {
  flip: false
});

dicebear identicon --flip false

rotate

Type integerMinimum 0Maximum 360

0

90

180

270

0

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

createAvatar(identicon, {
  rotate: 0
});

dicebear identicon --rotate 0

scale

Type integerMinimum 0Maximum 200

50

100

200

100

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

createAvatar(identicon, {
  scale: 50
});

dicebear identicon --scale 50

radius

Type integerMinimum 0Maximum 50

0

10

20

30

40

50

0

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

createAvatar(identicon, {
  radius: 0
});

dicebear identicon --radius 0

size

Type integerMinimum 1

32

48

64

80

96

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

createAvatar(identicon, {
  size: 32
});

dicebear identicon --size 32

backgroundColor

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

b6e3f4

c0aede

d1d4f9

ffd5dc

ffdfbf

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

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

dicebear identicon --backgroundColor "b6e3f4" "c0aede" "d1d4f9"

backgroundType

Type array

gradientLinear

solid

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

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

dicebear identicon --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/identicon/svg?backgroundRotation=0,360

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

dicebear identicon --backgroundRotation 0 360

translateX

Type integerMinimum -100Maximum 100

-50

-25

0

25

50

0

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

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

dicebear identicon --translateX -50

translateY

Type integerMinimum -100Maximum 100

-50

-25

0

25

50

0

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

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

dicebear identicon --translateY -50

clip

Type boolean

true

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

createAvatar(identicon, {
  clip: true
});

dicebear identicon --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/identicon/svg?randomizeIds=false

createAvatar(identicon, {
  randomizeIds: false
});

dicebear identicon --randomizeIds false

row1

Type array

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

https://api.dicebear.com/9.x/identicon/svg?row1=ooxoo,oxoxo,oxxxo

createAvatar(identicon, {
  row1: ["ooxoo","oxoxo","oxxxo"]
});

dicebear identicon --row1 "ooxoo" "oxoxo" "oxxxo"

row2

Type array

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

https://api.dicebear.com/9.x/identicon/svg?row2=ooxoo,oxoxo,oxxxo

createAvatar(identicon, {
  row2: ["ooxoo","oxoxo","oxxxo"]
});

dicebear identicon --row2 "ooxoo" "oxoxo" "oxxxo"

row3

Type array

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

https://api.dicebear.com/9.x/identicon/svg?row3=ooxoo,oxoxo,oxxxo

createAvatar(identicon, {
  row3: ["ooxoo","oxoxo","oxxxo"]
});

dicebear identicon --row3 "ooxoo" "oxoxo" "oxxxo"

row4

Type array

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

https://api.dicebear.com/9.x/identicon/svg?row4=ooxoo,oxoxo,oxxxo

createAvatar(identicon, {
  row4: ["ooxoo","oxoxo","oxxxo"]
});

dicebear identicon --row4 "ooxoo" "oxoxo" "oxxxo"

row5

Type array

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

ooxoo

oxoxo

oxxxo

xooox

xoxox

xxoxx

xxxxx

https://api.dicebear.com/9.x/identicon/svg?row5=ooxoo,oxoxo,oxxxo

createAvatar(identicon, {
  row5: ["ooxoo","oxoxo","oxxxo"]
});

dicebear identicon --row5 "ooxoo" "oxoxo" "oxxxo"

rowColor

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

00acc1

1e88e5

5e35b1

6d4c41

7cb342

8e24aa

039be5

43a047

546e7a

00897b

3949ab

757575

c0ca33

d81b60

e53935

f4511e

fb8c00

fdd835

ffb300

https://api.dicebear.com/9.x/identicon/svg?rowColor=00acc1,1e88e5,5e35b1

createAvatar(identicon, {
  rowColor: ["00acc1","1e88e5","5e35b1"]
});

dicebear identicon --rowColor "00acc1" "1e88e5" "5e35b1"

Details

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

Source
Title	Identicon
Creator	DiceBear
Website	https://www.dicebear.com
License	CC0 1.0
Source	https://www.dicebear.com

Identicon ​

Usage ​

Options ​

seed

flip

rotate

scale

radius

size

backgroundColor

backgroundType

backgroundRotation

translateX

translateY

clip

randomizeIds

row1

row2

row3

row4

row5

rowColor

Details ​

Identicon

Usage

Options

Details