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

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.

flip

Type boolean

rotate

Type integer

Minimum 0

Maximum 360

scale

Type integer

Minimum 0

Maximum 200

radius

Type integer

Minimum 0

Maximum 50

size

Type integer

Minimum 1

backgroundColor

Type array

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

backgroundType

Type array

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'].

translateX

Type integer

Minimum -100

Maximum 100

translateY

Type integer

Minimum -100

Maximum 100

clip

Type boolean

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.

textColor

Type array

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

fontFamily deprecated

Type array

WARNING

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

fontSize deprecated

Type integer

Minimum 1

Maximum 100

chars deprecated

Type integer

Minimum 0

Maximum 2

fontWeight deprecated

Type integer

WARNING

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

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