# Changelog

To find the full documentation go to <https://dicebear.vhjan.me/>\
You can click certain `blocks` to go to its documentation page.\
\
If you encounter any bugs or errors, please open an [issue](https://github.com/jvherck/dicebear/issues).

***

## v3.9.4

2026-01-15

### Added

* New style [`toon-head`](https://dicebear.vhjan.me/start/customization#styles)

***

## v3.9.3

2025-03-03

### Changed

* [`DAvatar`](https://dicebear.vhjan.me/reference/avatar#class-davatar) now has a new parameter `save_to_cache` (default True) to choose whether to save avatars to the cache or not. Caching them will make it easier and quicker to access the avatars again, and will reduce outgoing API calls.

***

## v3.9.2

2025-01-04

### Back-end

The back-end has been reworked a lot to make the whole framework faster and more efficient. The package now also supports caching to avoid making redundant requests.

A safer way of making requests to avoid hanging indefinitely or raising generic/unnecessary errors has been implemented.

***

## v2.9.2

2024-07-28

### Added

* New styles [`dylan`](https://dicebear.vhjan.me/start/customization#styles) and [`glass`](https://dicebear.vhjan.me/start/customization#styles)
* New modern alternative file formats [`webp`](https://dicebear.vhjan.me/start/customization#formats) and [`avif`](https://dicebear.vhjan.me/start/customization#formats) (use these instead of `png` or `jp(e)g`)

***

## v2.7.5

2024-07-06

### Back-end

* Dicebear version upgrade to 9.x

### Improvements

* Added tox for code quality automation

### Changed

* Moved style metadata to separate file [`dicebear.metadata.Metadata`](https://dicebear.vhjan.me/reference/metadata#variables)

***

## v2.7.4

2024-04-24

### Back-end

* Back-end cleanup
* Dicebear version upgrade to 8.x (API bug fixes)

***

## v2.7.3

2024-03-09

### Added

* [`styles_metadata`](https://dicebear.vhjan.me/reference/models#variables) (models.py) to directly get metadata of every style

### Back-end

* Made usage stats opt-in with environment variable [`ENABLE_PYTHON_DICEBEAR_USAGE_STATS`](https://dicebear.vhjan.me/start/statistics) set to true

### Fixed

* [`notionists`](https://dicebear.vhjan.me/start/customization#styles) and [`notionists-neutral`](https://dicebear.vhjan.me/start/customization#styles) were not implemented but have been added now

***

## v2.7.2

2023-12-12

### Added

* New attribute [`schema`](https://dicebear.vhjan.me/reference/avatar#properties) for [`DAvatar`](https://dicebear.vhjan.me/reference/avatar#class-davatar) class

### Back-end

* Removed `test` parameter on all functions
* Improved type hinting and imports

***

## v2.7.1

2023-12-12

### Added

* New attribute [`schema`](https://dicebear.vhjan.me/reference/avatar#properties) for [`DAvatar`](https://dicebear.vhjan.me/reference/avatar#properties) class

### Back-end

* Removed `test` parameter on all functions
* Improved type hinting and imports

***

## v2.7.0

2023-08-29

### Added

* New style [`rings`](https://dicebear.vhjan.me/start/customization#styles)
* New function [`DStyle.get_schema(style: str)`](https://dicebear.vhjan.me/reference/models#def-get_schema) to get the schema (all properties) of the given avatar style

### Back-end

* Upgrade to Dicebear new API version 7.0

***

## v2.6.1

2023-04-11

### Added

* New style [`notionists`](https://dicebear.vhjan.me/start/customization#styles)
* New style [`notionists-neutral`](https://dicebear.vhjan.me/start/customization#styles)

### Back-end

* Upgrade to Dicebear new API version 6.0

***

## v2.5.2

2023-03-21

### Back-end

* The package now pings an API to update the usage statistics (nothing personal is stored, it simply increments the amount of times certain functions have been used)

***

## v2.5.1

2023-03-16

### Removed

* Properties `DAvatar.text` and `DAvatar.bytes`

### Added

* Methods [`DAvatar.text(format)`](https://dicebear.vhjan.me/reference/avatar#def-text) and [`DAvatar.bytes(format)`](https://dicebear.vhjan.me/reference/avatar#def-bytes)

### Fixed

* [`DAvatar.pillow()`](https://dicebear.vhjan.me/reference/avatar#def-pillow) no longer raises error for no reason


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dicebear.vhjan.me/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.