Release notes

Get an overview of the things changed and fixed in each version of Umbraco Deploy.

In this section we have summarized the changes to Umbraco Deploy and Deploy Contrib released in each version. Each version is presented with a link to the Deploy issue tracker 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.

If you are upgrading to a new major version you can find the details about the breaking changes in the version specific updates article.

Release history

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

16.0.4 (October 9th 2025)

• Fix regression in serializing property values with segments

16.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

• Remove double space and fix status layout (scrollable error details) #288 and #284

16.0.2 (September 24th 2025)

• Migrate form picker grid editor as macro #274

• Avoid NullReferenceException when serializing property values with segments

16.0.1 (September 5th 2025)

• Fix remote entity tree implementation causing conflicts with CMS culture switcher, tree icons, and inherited document permissions #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

16.0.0 (May 12th 2025)

• Compatibility with Umbraco 16.0.0

16.0.0-rc5 (May 10th 2025)

• Compatibility with Umbraco 16.0.0-rc6

16.0.0-rc4 (May 10th 2025)

• Compatibility with Umbraco 16.0.0-rc5

• Removed obsolete code

16.0.0-rc3 (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 (May 30th 2025)

• Compatibility with Umbraco 16.0.0-rc3

• Rename/add CancellationToken parameters and add ConfigureAwait(false) to awaits

16.0.0-rc1 (May 16th 2025)

• Compatibility with Umbraco 16.0.0-rc2

  • See full details of breaking changes under the Version-specific Upgrade Guide

Umbraco.Deploy.Contrib

16.0.2 (October 9th 2025)

• Migrate actual prevalue property value (when importing legacy artifacts) #72

• Ensure legacy migrators are inserted at the beginning of the collection #73

16.0.1 (July 11th 2025)

• Recursively migrate Doc Type Grid Editor (DTGE) property values #270

16.0.0 (May 12th 2025)

• Compatibility with Umbraco 16.0.0 and Deploy 16.0.0

16.0.0-rc5 (May 10th 2025)

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

16.0.0-rc4 (May 10th 2025)

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

16.0.0-rc3 (May 3rd 2025)

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

16.0.0-rc2 (May 30th 2025)

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

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 and Umbraco Deploy Package page