# Release notes

In this section we have summarized the changes to Umbraco Deploy and [Deploy Contrib](https://github.com/umbraco/Umbraco.Deploy.Contrib) released in each version. Each version is presented with a link to the [Deploy issue tracker](https://github.com/umbraco/Umbraco.Deploy.Issues/issues) showing a list of issues resolved in the release. We also link to the individual issues themselves from the detail.

If there are any breaking changes or other issues to be aware of when upgrading they are also noted here.

{% hint style="info" %}
If you are upgrading to a new major version you can find the details about the breaking changes in the [version specific updates](/umbraco-deploy/16.latest/upgrading/version-specific.md) article.
{% endhint %}

## Release history

This section contains the release notes for Umbraco Deploy 16 including all changes for this version.

### [16.0.6](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.6) (March 5th 2026)

* Set create date on new documents/media/members [#259](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/259)
* Request children/structure reload and entity update after import or restore [#286](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/286)
* Fix `InvalidOperationException` when getting value from `JsonValue` [#324](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/324)
* Ensure all blocks are exposed during migration [#325](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/325)
* Maintain reverse UDI order when cleaning entities [#327](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/327)

### [16.0.5](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.5) (January 8th 2026)

* Register all supported entity types on back-end and front-end [#273](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/273)
* Set environment URL when fetching remote items and close dropdown after changing environment [#300](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/300)

### [16.0.4](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.4) (October 9th 2025)

* Fix regression in serializing property values with segments

### [16.0.3](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.3) (October 3rd 2025)

* Fix skipping non-existent or null artifact properties (ensure all property values are processed)
* Support migrating RTE editor UI from TinyMCE to Tiptap (data type configuration)
* Expose block level variants when migrating Nested Content [#281](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/281)
* Remove double space and fix status layout (scrollable error details) [#288](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/288) and [#284](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/284)

### [16.0.2](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.2) (September 24th 2025)

* Migrate form picker grid editor as macro [#274](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/274)
* Avoid `NullReferenceException` when serializing property values with segments

### [16.0.1](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.1) (September 5th 2025)

* Fix remote entity tree implementation causing conflicts with CMS culture switcher, tree icons, and inherited document permissions [#275](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/275)
* Fix remote entity pickers not showing tree items (when selecting an item for partial restore)
* Fix document-specific Deploy permissions
* Fix dashboard UI layout issues and translations
* Set default row span in block area configuration when migrating to Block Grid editor [#270](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/270#issuecomment-3068861453)

### [16.0.0](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 12th 2025)

* Compatibility with Umbraco 16.0.0

### [16.0.0-rc5](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 10th 2025)

* Compatibility with Umbraco 16.0.0-rc6

### [16.0.0-rc4](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 10th 2025)

* Compatibility with Umbraco 16.0.0-rc5
* Removed obsolete code

### [16.0.0-rc3](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 3rd 2025)

* Compatibility with Umbraco 16.0.0-rc4
* Add `deployEntityTypeMapping` manifest to allow mapping client-side entity types (used in workspaces and routes) to their server-side entity types (used in UDIs, artifacts, and service connectors)
* Use default `TryParseUdiRangeFromNodeId` implementation for internally registered entity types

### [16.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 30th 2025)

* Compatibility with Umbraco 16.0.0-rc3
* Rename/add `CancellationToken` parameters and add `ConfigureAwait(false)` to awaits

### [16.0.0-rc1](https://github.com/umbraco/Umbraco.Deploy.Issues/issues?q=is%3Aissue+is%3Aclosed+label%3Arelease%2F16.0.0) (May 16th 2025)

* Compatibility with Umbraco 16.0.0-rc2
  * See full details of breaking changes under the [Version-specific Upgrade Guide](/umbraco-deploy/16.latest/upgrading/version-specific.md)

## Umbraco.Deploy.Contrib

### [16.0.2](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.2) (October 9th 2025)

* Migrate actual prevalue property value (when importing legacy artifacts) [#72](https://github.com/umbraco/Umbraco.Deploy.Contrib/pull/72)
* Ensure legacy migrators are inserted at the beginning of the collection [#73](https://github.com/umbraco/Umbraco.Deploy.Contrib/pull/73)

### [16.0.1](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.1) (July 11th 2025)

* Recursively migrate Doc Type Grid Editor (DTGE) property values [#270](https://github.com/umbraco/Umbraco.Deploy.Issues/issues/270)

### [16.0.0](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0) (May 12th 2025)

* Compatibility with Umbraco 16.0.0 and Deploy 16.0.0

### [16.0.0-rc5](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc5) (May 10th 2025)

* Compatibility with Umbraco 16.0.0-rc6 and Deploy 16.0.0-rc5

### [16.0.0-rc4](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc4) (May 10th 2025)

* Compatibility with Umbraco 16.0.0-rc5 and Deploy 16.0.0-rc4

### [16.0.0-rc3](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc3) (May 3rd 2025)

* Compatibility with Umbraco 16.0.0-rc4 and Deploy 16.0.0-rc3

### [16.0.0-rc2](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc2) (May 30th 2025)

* Compatibility with Umbraco 16.0.0-rc3 and Deploy 16.0.0-rc2

### [16.0.0-rc1](https://github.com/umbraco/Umbraco.Deploy.Contrib/releases/tag/release-16.0.0-rc1) (May 20th 2025)

* Compatibility with Umbraco 16.0.0-rc2 and Deploy 16.0.0-rc1
* Update `TinyMCEv3DataTypeArtifactMigrator` to migrate legacy (v7) Umbraco.TinyMCEv3 to Umbraco.RichText with Tiptap UI editor

## Legacy release notes

You can find the release notes for versions out of support in the [Legacy documentation on GitHub](https://github.com/umbraco/UmbracoDocs/blob/umbraco-eol-versions/11/umbraco-deploy/release-notes.md) and [Umbraco Deploy Package page](https://our.umbraco.com/packages/developer-tools/umbraco-deploy/)


---

# 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://docs.umbraco.com/umbraco-deploy/16.latest/release-notes.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.
