✏️Customization

Customise your avatars with these possibilities. There are over 1 sexdecillion (that's 17 zero's!) unique possibilities!

Styles

All the possible avatar styles. https://dicebear.com/styles

  • adventurer

  • adventurer-neutral

  • avataaars

  • avataaars-neutral

  • big-ears

  • big-ears-neutral

  • big-smile

  • bottts

  • bottts-neutral

  • croodles

  • croodles-neutral

  • dylan

  • fun-emoji

  • glass

  • icons

  • identicon

  • initials

  • lorelei

  • lorelei-neutral

  • micah

  • miniavs

  • notionists

  • notionists-neutral

  • open-peeps

  • personas

  • pixel-art

  • pixel-art-neutral

  • rings

  • shapes

  • thumbs

Base Options

All the possible options for the avatar. These options work for all the styles.

  • seed (type: str) - the seed for the avatar generator, determine its basic looks

  • flip (type: bool) - flips the image vertically (default False)

  • rotate (type: int) - rotates the avatar (default 0, min 0, max 360)

  • scale (type: int) - the scale of the avatar drawing itself (default 100, min 0, max 200)

  • radius (type: int) - the radius of the avatar (default 0, min 0, max 50)

  • size (type: int) - the size of the avatar (px) (default 256, min 1, max 256)

  • backgroundColor (type: DColor( "transparent" ) ) - the background color of the avatar (default transparent)

  • backgroundType (type: str) - the type of background (only solid or gradientLinear)

  • backgroundRotation (type: int) - the rotation of the background (only with gradientLinear)

  • translateX (type: int) - move the avatar horizontally (default 0, min -100, max 100)

  • translateY (type: int) - move the avatar vertically (default 0, min -100, max 100)

  • randomizeIds (type: bool) - randomize the IDs in the generated SVG/XML, can be useful if the avatars are included directly in HTML and you want to avoid ID conflicts (default False)

Specific Style Options

Specific options to get a more detailed avatar. This is different for every style. Click the style to see its options.

Formats

These are the only supported formats. If you have Pillow (PIL) installed you can convert DAvatar to a PIL.Image.Image object to get a wider range of formats (Pillow doesn't support svg).

  • DFormat.svg (default)

  • DFormat.webp

  • DFormat.avif

  • DFormat.png

  • DFormat.jpg

  • DFormat.jpeg

  • DFormat.json

Last updated