Initials

Initials is a text-based vector avatar style that renders one or two large letters centered on a solid colored square: the classic monogram placeholder. It is deterministic and readable, which makes it a practical fallback for users who haven't uploaded a profile picture yet.

Preview

Open Playground

LICENSE

Initials by DiceBear, licensed under CC0 1.0. See details for more information.

Usage

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

https://api.dicebear.com/10.x/initials/svg

You can use the URL directly as image source.

<img
  src="https://api.dicebear.com/10.x/initials/svg"
  alt="avatar"
/>

See HTTP-API docs for more information.

First install the required packages via npm:

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

Then you can create this avatar as follows:

import { Style, Avatar } from '@dicebear/core';
import definition from '@dicebear/styles/initials.json' with { type: 'json' };

const style = new Style(definition);
const avatar = new Avatar(style, {
  // ... options
});

const svg = avatar.toString();

See JS docs for more information.

First install the required packages via Composer:

composer require dicebear/core dicebear/styles

Then you can create this avatar as follows:

<?php

use Composer\InstalledVersions;
use DiceBear\Style;
use DiceBear\Avatar;

$basePath = InstalledVersions::getInstallPath('dicebear/styles');
$definition = json_decode(file_get_contents($basePath . '/src/initials.json'), true);

$style = new Style($definition);
$avatar = new Avatar($style, [
  // ... options
]);

$svg = (string) $avatar;

See PHP docs for more information.

First install the required packages via pip:

pip install dicebear-core dicebear-styles

Then you can create this avatar as follows:

import json
from importlib.resources import files

from dicebear import Avatar, Style

definition = json.loads(
    files("dicebear_styles").joinpath("initials.json").read_text("utf-8")
)

style = Style(definition)
avatar = Avatar(style, {
    # ... options
})

svg = avatar.to_string()

See Python docs for more information.

First add the required crates via Cargo:

cargo add dicebear-core serde_json
cargo add dicebear-styles --features initials

Then you can create this avatar as follows:

use dicebear_core::{Avatar, Style};
use serde_json::json;

let style = Style::from_str(dicebear_styles::INITIALS)?;
let avatar = Avatar::new(&style, json!({
  // ... options
}))?;

let svg = avatar.to_svg();

See Rust docs for more information.

First add the required modules with go get:

go get github.com/dicebear/dicebear-go/v10
go get github.com/dicebear/styles/v10

Then you can create this avatar as follows:

import (
	dicebear "github.com/dicebear/dicebear-go/v10"
	"github.com/dicebear/styles/v10"
)

style, _ := dicebear.NewStyle([]byte(styles.Initials))
avatar, _ := dicebear.NewAvatar(style, map[string]any{
	// ... options
})

svg := avatar.SVG()

See Go docs for more information.

First install the CLI package via npm:

npm install --global dicebear

Then you can create this avatar as follows:

dicebear initials

See CLI docs for more information.

Options

Details

Naming

Definition Import	import definition from '@dicebear/styles/initials.json' with { type: 'json' };
CLI	dicebear initials
HTTP-API	https://api.dicebear.com/10.x/initials/svg
Definition	https://cdn.hopjs.net/npm/@dicebear/styles@10.1.0/dist/initials.min.json

Source

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