Identicon

Identicon renders symmetrical pixel-grid patterns in a single color on a tinted background, the classic identicon look popularised by developer tools and version control hosts. Each pattern is deterministically derived from its seed, so it works well for technical profile icons and identicon API use cases.

Preview

Open Playground

LICENSE

Identicon 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/identicon/svg

You can use the URL directly as image source.

<img
  src="https://api.dicebear.com/10.x/identicon/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/identicon.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/identicon.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("identicon.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 identicon

Then you can create this avatar as follows:

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

let style = Style::from_str(dicebear_styles::IDENTICON)?;
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.Identicon))
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 identicon

See CLI docs for more information.

Options

Details

Naming

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

Source

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