Initials

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/initials/:seed.svg

See the HTTP API documentation for more information.

NPM

Install the Avatars and this avatar style with the following command.

npm install --save @dicebear/avatars @dicebear/avatars-initials-sprites

Now you are ready to create your first Avatar.

import { createAvatar } from '@dicebear/avatars';

import * as style from '@dicebear/avatars-initials-sprites';

let svg = createAvatar(style, {

seed: 'custom-seed',

// ... and other options

});

Options

Base options

seed Seed Alias: s Default: undefined Type: string

dataUri Data URI Default: false Type: boolean

flip Flip Default: false Type: boolean

rotate Rotate Default: 0 Type: integer Minimum: 0 Maximum: 360

scale Scale Default: 100 Type: integer Minimum: 0 Maximum: 200

radius Radius Alias: r Default: 0 Type: integer Minimum: 0 Maximum: 50

size Size Default: undefined Type: integer Minimum: 1

backgroundColor Background Color Alias: b Default: undefined Type:

translateX Translate X% Default: 0 Type: integer Minimum: -100 Maximum: 100

translateY Translate Y% Default: 0 Type: integer Minimum: -100 Maximum: 100

Style options

backgroundColors Background Colors Default: undefined Type: array Items: Type: string Enum: amber, blue, blueGrey, brown, cyan, deepOrange, deepPurple, green, grey, indigo, lightBlue, lightGreen, lime, orange, pink, purple, red, teal, yellow

backgroundColorLevel Background Color Level Default: 600 Type: integer Enum: 50, 100, 200, 300, 400, 500, 600, 700, 800, 900

fontSize Font Size Default: 50 Type: integer Minimum: 1 Maximum: 100

chars Chars Default: 2 Type: number Minimum: 0 Maximum: 2

bold Bold Default: undefined Type: boolean