DiceBear Files

DiceBear 10.4 is about artwork: thirteen new avatar styles in a single release, the most we have ever shipped at once. The catalog now counts 50 styles. Twelve of the newcomers can move, four styles you already know learned it too, and the new tags option is the switch that turns it on.

🎨 Thirteen new styles

All thirteen are DiceBear originals, released under CC0 1.0. Use them anywhere, commercial projects included, no attribution required. Below, six seeds per style, so you can see how far each one stretches. Every style name links to its page with all options, all variants, and a playground.

Moods

A big pastel face on a deep background, drawn for product UIs. Nine face shapes, sixteen eye sets, fifteen mouths, and the smiling ones come up more often. When animated, it blinks.

Critters

A small bug-like creature in shaded pastel, usually with an attachment in a second color. Fourteen bodies, nineteen eye sets, and nineteen mouths. When animated, it bobs, blinks, and its top sway.

Sprouts

A potted plant with the face on the pot: twelve plants, seven pot shapes, and the Critters face set. When animated, the plant sways and the face blinks.

Clay

A hand-molded plasticine creature on a warm paper backdrop: fourteen wobbly silhouettes with googly eyes and carved mouths. When animated, the body squashes gently and the pupils wobble.

Pixelbot

An AI bot face on a 12x12 LED panel: seven eye sets, five mouths, nine glow colors, and ten dark backgrounds. With animation on, the eyes blink row by row and every pixel switches hard, like a real LED.

Planets

A single planet in deep space: ten surface variants, an optional ring, moons, and a random star field. shadeVariant switches to a crisp two-tone shading.

Constellation

A constellation over a night sky, drawn from real star data, plus a per-seed star field, an occasional shooting star, and two rare easter eggs.

Landscape

An abstract layered landscape: four hill bands, an optional sun or moon, and curated nature palettes that keep every random combination harmonious.

Loops

A truchet pattern: quarter-circle arc tiles on a 3x3 grid join into meandering paths, tone in tone with the background. patternVariant switches to plain white or black. When animated, tiles quarter-turn and keep reconfiguring the pattern.

Squircles

A depth stack of three to five nested superellipses. Opacity rises toward the center, each layer is jittered and rotated, and most seeds carry a small accent squircle.

Blobs

Two to four layered organic forms in white or black over a strong background color. Compositions range from calm concentric stacks to off-center clusters.

Waves

Three to six translucent wave bands over a saturated background color, freely rotated per seed. rotationVariant locks the direction.

Weave

A woven tartan pattern: two to three translucent bands per axis over a light tinted tile. Band positions are continuous, so two seeds practically never share a design. Static by design, the one new style without an animation.

🎬 Avatars that move

The avatars below are ordinary <img> tags pointing at the HTTP API. What you see is what the API returns. If they hold still, your system asks for reduced motion, and the avatars respect that.

Moods

Critters

Sprouts

Clay

Pixelbot

Thumbs

Twelve of the new styles ship an animation. So do four styles that have been around for a while: Shapes, Glass, Thumbs, and Initial Face.

Everything is off by default. An avatar renders as fully static markup until you opt in, either by pinning a speed or by tag:

:::js
// pin a speed, from 'fastest' to 'slowest'
const avatar = new Avatar(style, { seed: 'Felix', animationVariant: 'medium' });

// or let the seed pick a speed
const avatar = new Avatar(style, { seed: 'Felix', tags: ['animation'] });

The same works in the HTTP API:

https://api.dicebear.com/10.x/critters/svg?seed=Felix&animationVariant=medium
https://api.dicebear.com/10.x/critters/svg?seed=Felix&tags=animation

The animation is plain CSS inside the SVG, without a line of JavaScript. It runs in <img> tags and CSS backgrounds and honors prefers-reduced-motion. Browsers without :has() support show the static artwork instead, and raster formats such as PNG render the resting pose.

All animated styles at a glance: https://www.dicebear.com/animated-avatars/

🏷️ Filter variants with tags

Styles can now label their variants with tags, and the new tags render option filters the variant pool by those labels. You pin down one trait, the seed keeps deciding everything else. The option ships in all six libraries and as a tags query parameter in the HTTP API.

A token is a category (animation) or a category with a value (mood:positive), and a leading ! excludes. Several values of one category act as "or", different categories act as "and". A per-component option such as mouthVariant is more specific and switches the filter off for that component.

Right now the DiceBear styles use tags for one thing: the animation you saw above. tags=animation switches it on, tags=!animation keeps it off. The character categories follow in a later release, with tags for mood, hair length, facial hair, eyewear, and more. The goal is that something like tags=mood:positive keeps a whole avatar set smiling without touching any other option.

Two new guides cover the details:

• Filter Avatar Variants with Tags
• How DiceBear Tags Variants

🧰 Also in 10.4

• CLI: dicebear ./my-style.json --optimize compresses a style definition in place, up to 42% for older files. --optimize-check reports without writing and works as a CI gate.
• Converter: Rotated styles with translucent layers no longer lose parts of the image when rasterized. The Waves style was hit hardest and lost about half of its artwork in every raster format.
• Core: <defs> ids are now hashed from style and seed together. Two avatars of different styles with the same seed can be inlined on one page without stealing each other's defs.
• Heads up for snapshot tests: The generator comment now points at https://www.dicebear.com, and the id change above alters rendered bytes too. Stored SVG snapshots from 10.3 need an update.

Everything else is in the changelog.