Initials

Initials 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/initials/svg

You can use the URL directly as image source.

See HTTP-API 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/initials/svg?seed=Felix

flip

Type boolean

false

true

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

rotate

Type integerMinimum 0Maximum 360

0

90

180

270

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

scale

Type integerMinimum 0Maximum 200

50

100

200

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

radius

Type integerMinimum 0Maximum 50

0

10

20

30

40

50

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

size

Type integerMinimum 1

32

48

64

80

96

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

backgroundColor

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

b6e3f4

c0aede

d1d4f9

ffd5dc

ffdfbf

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

backgroundType

Type array

gradientLinear

solid

https://api.dicebear.com/9.x/initials/svg?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/initials/svg?backgroundRotation=0,360

translateX

Type integerMinimum -100Maximum 100

-50

-25

0

25

50

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

translateY

Type integerMinimum -100Maximum 100

-50

-25

0

25

50

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

clip

Type boolean

true

https://api.dicebear.com/9.x/initials/svg?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/initials/svg?randomizeIds=false

textColor

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

ffffff

https://api.dicebear.com/9.x/initials/svg?textColor=ffffff

fontFamily deprecated

Type array

WARNING

This option is not supported by the HTTP-API for PNG and JPEG.

Arial

Brush Script MT

Courier New

Garamond

Georgia

Helvetica

sans-serif

serif

Tahoma

Times New Roman

Trebuchet MS

Verdana

https://api.dicebear.com/9.x/initials/svg?fontFamily=Arial,Brush%20Script%20MT,Courier%20New

fontSize deprecated

Type integerMinimum 1Maximum 100

50

https://api.dicebear.com/9.x/initials/svg?fontSize=50

chars deprecated

Type integerMinimum 0Maximum 2

2

https://api.dicebear.com/9.x/initials/svg?chars=2

fontWeight deprecated

Type integer

WARNING

This option is not supported by the HTTP-API for PNG and JPEG.

100

200

300

400

500

600

700

800

900

https://api.dicebear.com/9.x/initials/svg?fontWeight=100

Details

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

Source
Title	Initials
Creator	DiceBear
License	CC0 1.0
Source	https://github.com/dicebear/dicebear