All notable changes to the DiceBear API will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
This repository is the self-hostable HTTP API for DiceBear, published as a Docker
image on Docker Hub. The package itself
is private and unpublished. The version lives only in the Git tag, and the
docker.yml workflow builds the image on every
v* tag. Versions track the API's own release line (4.x), independently of the
DiceBear library.
4.10.0-rc.2 - 2026-07-31
4.10.0-rc.1 - 2026-07-31
4.9.1 - 2026-07-29
- Refreshed
package-lock.jsonwithin the existing version ranges.@dicebear/coreand@dicebear/converternow resolve to10.3.2(was10.3.0). This picks up the converter fix that keeps text nodes, CDATA sections, and deep nesting intact.@dicebear/schemaresolves to1.3.0(was1.2.0). Transitive dependencies moved as well, among themfastify(5.10.0) andsharp(0.35.3).
4.9.0 - 2026-06-13
- Updated
@dicebear/coreand@dicebear/converterto^10.3.0(was^10.2.0).
4.8.0 - 2026-06-10
- New per-style endpoints
/{version}.x/{style}/definition.json(raw style definition) and/{version}.x/{style}/options.json(options descriptor, without the options listed inEXCLUDED_OPTIONS). Both are disabled by default and can be enabled individually via the newDEFINITIONandOPTIONSenvironment variables.
4.7.0 - 2026-06-06
- The version root endpoint (e.g.
/10.x) now returns the list of available style names as{ "styles": [...] }, sorted alphabetically, so clients can discover supported styles. The response is cached via the newCACHE_CONTROL_STYLESenvironment variable (default 1 hour).
4.6.0 - 2026-06-03
- Updated
@dicebear/styles-10to^10.1.0(was^10.0.0), which fixes the Lorelei mouth showing through beard variants and the Rings shape rendering. - Updated
@dicebear/schemato^1.1.0(was^1.0.0).