Release notes

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

In this section we have summarised 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 4 and 10 including all changes for these versions. For each major version, you can find the details about each release.

10.4.1 (November 29th 2024)

• Add [DisableRequestSizeLimit] attribute to UploadForImport endpoint to remove application request size limit (server/infrastructure restrictions may still apply)

• Fixed issue where content was not saved when transferring variant content with a release date

• Support flexible environments on Umbraco Cloud (remove requirement for environment types to be Development, Staging or Live)

• Update documentation links in management dashboard to include major version in the URL

10.4.0 (March 19th 2024)

• All items from 10.4.0-rc1

• Fixed issue with transfer of date values within Nested Content, Block List or Block Grid properties #209

• Back-ported fix where templates could incorrectly cause schema mismatch errors when running in production mode. Although runtime modes aren't available in Umbraco 8, we ensure that the template .uda files are correctly processed by always setting the template path. #187

• Fixed issue where importing invalid variant property data would cause a not supported variation exception #8

• Fixed deserialization issue causing problems with the compare content feature #212

10.4.0-rc1 (March 5th 2024)

• Add IArtifactTypeResolver to allow custom type resolving when deserializing to IArtifact (used by Deploy Contrib, see PR #60)
• Add base migrators for importing legacy artifacts (used by Deploy Contrib)

• Restored ability to overwrite content properties with empty values

• Improved error UX and messaging to only show technical detail option if available

• Require a valid license when importing

10.3.4 (February 20th 2024)

• Removed the no-longer supported "live edit" feature (Deploy on Cloud only).

• Fixed issue where the removal of a master template couldn't be deployed #201
• Ensured configuration for behavior following a "path too long" exception is respected for handling image cropper values #200
• User experience and message improvements on content flow exception #202
• Fixed issue with transfer of empty values to overwrite non-empty ones.

10.3.3 (January 16th 2024)

• Added configurable option to avoid overwriting of dictionary items with empty values #191

  • For more details see the page on Deploy's settings.
• Fixed regression issue with transfer of date values.

10.3.2 (January 9th 2024)

• Fixed issue with transfer of content using language variants #193

10.3.1 (December 21th 2023)

• Fixes the display of the selected schedule date on queue for transfer.

• Fixes parsing property values within Nested Content and Block List that were previously saved by the Contrib value connectors.

• Fixed incorrectly including media files in export when 'Content files' wasn't selected.

• Add maximum file size validation to import file upload.

10.3.0 (December 11th 2023)

• All items from 10.3.0-rc1.

• Fixed a regression in 10.3.0-rc1 where content restore/transfers didn't use the same JSON converters when deserializing Deploy artifacts.

• Fixed permissions not being correctly set for administrators on initial install.

• Moved permissions from the Content to a new Deploy category (only affecting the UI).

• Add support for migrating property values within Nested Content, Block List and Block Grid, and include Multi URL Picker value connector (an explicit value connector binding is used to override the ones provided in Deploy Contrib).

• Added new configuration option of TrashedContentDeploymentOperations to allow exporting/importing of trashed content, ensuring referenced content in the recycle bin isn't exported by default and otherwise imports back into the recycle bin.

• Changed the default value connector to use the property storage type, instead of using custom value prefixes to store the object type.

10.3.0-rc1 (November 27th 2023)

• Added feature of content import and export with migrations.
• Added a new configuration option of ResolveUserInTargetEnvironment to allow resolving of user accounts in target environments (see Deploy Settings).
• Added a new configuration option of AllowPublicAccessDeploymentOperations to amend the behavior of public access rule transfer (see Deploy Settings).
• Improve performance of publishing multi-language content during restore/transfer and import.

10.2.7 (November 14th 2023)

• Fixed action menu for queue for transfer with list view #185.

10.2.6 (October 17th 2023)

• Fixed issue with deployment of content when scheduled for a future release date.

• Prevent dictionary items from being serialized to .uda files on disk when configured for transfer as content #184.

10.2.5 (October 10th 2023)

• Fixed regression issue introduced in 10.2.4 with deployment of properties of content templates #182

10.2.4 (September 19th 2023)

• Updated the transfer of user picker values to resolve the user by username in the target environment #180
• Also updated the logic for the member picker to ensure values representing members that don't exist in the target environment are cleared.

• Added configuration option to ignore missing languages when deploying translation items #176
• Ensured consistent sort of translations within dictionary items .uda files #175
• Ensured that alt text for images placed in grid cells are transferred #174
• Further fix to logic for creating redirects on content deployment for variant content #170
• Resolves issue with grid media items in a batched deployment operation.

• Increased size of database fields storing references to account for longer values used in package data Commerce #428
• Include published name in content transfer data to avoid overwriting with draft name if different.

• Optimized content transfers to include only draft and published versions when they exist.

• Fixed issue with partial restore of forms #178

10.2.3 (August 1st 2023)

• Ensured that schema files are updated on entity container renames #171.
• Fixed issue with processing of marker files on Linux #169.
• Corrected logic for creating redirects on content deployment for variant content.

• Ensured consistent rendering of trailing zeros when using the rounded decimal converter.

• Reduced some logging to debug to reduce noise in log files.

10.2.2 (May 30th 2023)

• Resolved a low impact security issue found in internal testing when triggering a schema extraction.

10.2.1 (May 23rd 2023)

• Added configuration for batch package processing and omitting post operation notification handlers.

• Handled use of trailing slash in configured environment URLs.

• Added sort option for the "is up to date" column in the schema comparison #165.
• Ensured artifacts serialized to disk are no longer processed when the entity is configured to be transferred as content.

• Handled updates to serialized document types on deletion of data types.

10.2.0 (April 11th 2023)

• Restricted languages available to editors when deploying variant content to those allowed via the user permissions for languages.

• Tidied up the Deploy dialogs for transfer, compare and restore to align with CMS conventions and remove redundant options.

• Added a database lock to the persistent transfer queue, removing any risk of concurrency issues when adding or removing items from the queue.

• Added support for new form properties introduced in the most recent minor release of Forms 11. #161

10.1.4 (March 21st 2023)

• Fixed issue with transfer of form workflow's "sensitive data" property. #159
• Fixed issue with datatype not found on cache rebuild #157
• Resolved issue with progress bar initialization on partial restore dialog

• Handled file not found issue when calculating media file checksum using file metadata

• Avoided exception triggered by custom tree implementations that do not expose an alias #160

10.1.2 (November 15th 2022)

• Added batch settings option providing resolution to large content or media transfers hitting Azure service limit #128

10.1.1 (October 18th 2022)

• Resolved issue with media restore when database items exist and files don't (backport fix to V4) #123
• Fixed issue with use of HTTP timeout setting (V9+)

10.1.0 (September 7th 2022)

• Introduced and used caching in deploy operations to improve performance.

• Increased default and added setting for disk operation timeouts #135
• Single language content transfers #132
• Scheduled content transfers.

• Corrected transfer of unpublished content status #131
• Improved UX and descriptions in backoffice settings dashboard #118
• Added ability to download Deploy artifacts (.uda files) as a zip archive from the management dashboard.

• Added sort options to the schema comparison view in the management dashboard #115
• Indented the JSON representation of Data Type configuration details in the .uda files for ease of review #85
• Fixed issue with transfer of Forms prevalue sources from text files that include captions.

• Ensured Document Type validation messages are transferred between environments #137
• Fixed issue with scheduled publish date being time shifted on deployments when source and target servers are running in different timezones.

• Fixed issue with transfer for members of a given type (V10 only) #139

10.0.3 (August 16th 2022)

• Aligned Git URL displayed in backoffice with that in Cloud Portal (V4 only) #136
• Fixed issue with deployment of root node value for Umbraco Forms's "save as Umbraco node" workflow #133
• Fixed incorrect availability of workspace restore in production environment (V9 and V10 only)

• Added close button to "Transfer now" dialog

• Resolved registration of deployable types to support configuration for "backoffice edition".

10.0.2 (July 12th 2022)

• Resolved issue with media restore when database items exist and files don't #123
• Added details of failed deployment to deploy dashboard #120
• Added copy button for deploy log in the backoffice #121
• Fixed typo in UI #113
• Ensured signature refresh on Data Type move into or out of folder #125
• Fixed selection of workspace for compare dialog

• Optimized existence checks in connectors

• Restore missing partial restore option in content and media tree roots (V9+)

• Fixed extract trigger URL in PowerShell script distributed with Deploy On-Premise (V9+)

• Improved deserialization of exceptions for clearer reporting (V9+)

10.0.1 (June 29th 2022)

• Fixed issue with deployment of content using variant properties #126

10.0.0 (June 16th 2022)

• Compatibility with .NET 6 and Umbraco 10

Version 4

4.10.0 (March 19th 2024)

• All items from 4.10.0-rc1

• Fixed issue with transfer of date values within Nested Content, Block List or Block Grid properties #209
• Fixed issue where templates could incorrectly cause schema mismatch errors when running in production mode #187
• Fixed issue where importing invalid variant property data would cause a not supported variation exception #8
• Fixed deserialization issue causing problems with the compare content feature #212

4.10.0-rc1 (March 5th 2024)

• Add IArtifactTypeResolver to allow custom type resolving when deserializing to IArtifact (used by Deploy Contrib, see PR #60)
• Add base migrators for importing legacy artifacts (used by Deploy Contrib)

• Restored ability to overwrite content properties with empty values

• Improved error UX and messaging to only show technical detail option if available

• Require a valid license when importing

• Remove Microsoft.Owin.Cors and Microsoft.AspNet.Cors dependencies

4.9.4 (February 20th 2024)

• Removed the no-longer supported "live edit" feature (Deploy on Cloud only).

• Fixed issue where the removal of a master template couldn't be deployed #201
• Ensured configuration for behavior following a "path too long" exception is respected for handling image cropper values #200
• User experience and message improvements on content flow exception #202
• Fixed issue with transfer of empty values to overwrite non-empty ones.

4.9.3 (January 16th 2024)

• Added configurable option to avoid overwriting of dictionary items with empty values #191

  • For more details see the page on Deploy's settings.
• Fixed regression issue with transfer of date values.

4.9.2 (January 9th 2024)

• Fixed issue with transfer of content using language variants #193

4.9.1 (December 21th 2023)

• Fixes the display of the selected schedule date on queue for transfer.

• Fixes parsing property values within Nested Content and Block List that were previously saved by the Contrib value connectors.

• Fixed incorrectly including media files in export when 'Content files' wasn't selected.

• Add maximum file size validation to import file upload.

4.9.0 (December 11th 2023)

• All items from 4.9.0-rc1.

4.9.0-rc1 (November 27th 2023)

• Added feature of content import and export with migrations.
• Added a new configuration option of ResolveUserInTargetEnvironment to allow resolving of user accounts in target environments (see Deploy Settings).
• Added a new configuration option of AllowPublicAccessDeploymentOperations to amend the behavior of public access rule transfer (see Deploy Settings).

4.8.4 (October 10th 2023)

• Fixed regression issue introduced in 4.8.3 with deployment of properties of content templates #182

4.8.3 (September 19th 2023)

• Updated the transfer of user picker values to resolve the user by username in the target environment #180
• Also updated the logic for the member picker to ensure values representing members that don't exist in the target environment are cleared.

• Added configuration option to ignore missing languages when deploying translation items #176
• Ensured consistent sort of translations within dictionary items .uda files #175
• Ensured that alt text for images placed in grid cells are transferred #174
• Further fix to logic for creating redirects on content deployment for variant content #170
• Resolves issue with grid media items in a batched deployment operation.

• Increased size of database fields storing references to account for longer values used in package data Commerce #428
• Include published name in content transfer data to avoid overwriting with draft name if different.

• Optimized content transfers to include only draft and published versions when they exist.

4.8.2 (August 1st 2023)

• Corrected logic for creating redirects on content deployment for variant content.

• Ensured consistent rendering of trailing zeros when using the rounded decimal converter.

• Reduced some logging to debug to reduce noise in log files.

4.8.1 (May 23rd 2023)

• Added configuration for batch package processing and omitting post operation notification handlers.

• Handled use of trailing slash in configured environment URLs.

• Added sort option for the "is up to date" column in the schema comparison #165.
• Ensured artifacts serialized to disk are no longer processed when the entity is configured to be transferred as content.

• Handled updates to serialized document types on deletion of data types.

4.8.0 (April 11th 2023)

• Tidied up the Deploy dialogs for transfer, compare and restore to align with CMS conventions and remove redundant options.

• Added a database lock to the persistent transfer queue, removing any risk of concurrency issues when adding or removing items from the queue.

4.7.4 (March 21st 2023)

• Fixed issue with datatype not found on cache rebuild #157

4.7.3 (February 21st 2023)

• All items listed under the 9.5.3, 10.1.3 and 11.0.1 releases (other than those indicated as only applying to higher versions).

4.7.2 (November 15th 2022)

• Added batch settings option providing resolution to large content or media transfers hitting Azure service limit #128

4.7.1 (October 18th 2022)

• Resolved issue with media restore when database items exist and files don't (backport fix to V4) #123
• Fixed issue with use of HTTP timeout setting (V9+)

4.7.0 (September 22nd 2022)

• Fixed issue with scheduled publish date being time shifted on deployments when source and target servers are running in different timezones.

• Fixed issue with transfer for members of a given type (V10 only) #139
• Introduced and used caching in deploy operations to improve performance.

• Increased default and added setting for disk operation timeouts #135
• Single language content transfers #132
• Scheduled content transfers.

• Corrected transfer of unpublished content status #131
• Improved UX and descriptions in backoffice settings dashboard #118
• Added ability to download Deploy artifacts (.uda files) as a zip archive from the management dashboard.

• Added sort options to the schema comparison view in the management dashboard #115
• Indented the JSON representation of Data Type configuration details in the .uda files for ease of review #85
• Fixed issue with transfer of Forms prevalue sources from text files that include captions.

• Ensured Document Type validation messages are transferred between environments #137

4.6.2 (August 16th 2022)

• Aligned Git URL displayed in backoffice with that in Cloud Portal (V4 only) #136
• Fixed issue with deployment of root node value for Umbraco Forms's "save as Umbraco node" workflow #133
• Fixed incorrect availability of workspace restore in production environment (V9 and V10 only)

• Added close button to "Transfer now" dialog

• Resolved registration of deployable types to support configuration for "backoffice edition".

4.6.1 (July 12th 2022)

• Resolved issue with media restore when database items exist and files don't #123
• Added details of failed deployment to deploy dashboard #120
• Added copy button for deploy log in the backoffice #121
• Fixed typo in UI #113
• Ensured signature refresh on Data Type move into or out of folder #125
• Fixed selection of workspace for compare dialog

• Optimized existence checks in connectors

• Restore missing partial restore option in content and media tree roots (V9+)

• Fixed extract trigger URL in PowerShell script distributed with Deploy On-Premise (V9+)

• Improved deserialization of exceptions for clearer reporting (V9+)

4.6.0 (April 26th 2022)

• Retained compact JSON formatting when transferring grid values

• Enhancements to content comparison dialog #101
• Partial restore for Forms and third-party plugins #100
• Display of configuration information and schema comparison on the deploy "settings" dashboard.

• Deployment of culture & hostname details #107
• Optional, automated clear of memory cache

• Resolved issue with empty value deployment of content based on the tags property editor #104
• Resolved issue with redirect functionality when records are deployed between environments (part of CMS #10066)
• Surfaced information about configuration for the ignore of broken dependencies in the dialog that presents the error information

• Fixed a CSS rendering issue for the deploy content dashboard's workspace display, when more than four environments are available.

• Fixed issue with deployment of empty tags data #104

4.5.0 (February 15th 2022)

• Content comparison dialog #65
• Backoffice deployment of members and member groups.

• Added support for deployment of history clean-up settings on Document Types (V4 only)

• Fixed bug with deployments of templates involving alias renames

4.4.4 (February 15th 2022)

• Fixed content transfer issue when public access login and error pages are created below the protected page #99
• Fixed issue with clashing permission letter for "queue for transfer" menu option (V4 only) #95

4.4.3 (January 25th 2022)

• Fixed ambiguous match exception when deploying forms (V4 only) #97
• Fixed issue with "live edit" component and scheduled publishing (V9 only) #98
• Amends to timing of file operation initialization to ensure third party components complete setup (V9 only).

• Added .NET 6 version of environment variable syntax for Umbraco Cloud configuration settings.

4.4.2 (December 21st 2021)

• Fixed issue with extractions triggered from uda files generated from older versions without property group aliases. #92
• Fixed timing issue for initiation of reading of file system triggers impacting third party Deploy integrations. #91

4.4.1 (December 7th 2021)

• Fixed issue relating to deployment of image alt text within the rich text editor. #87

4.4.0 (November 2nd 2021)

• Separate operations for "tree" and "workspace" restore #66
• Finer configuration options for ignoring broken dependencies #81
• Removed the redundant and misleading deploy operations available on the form "entries" menu item. #83
• Fixed issue with operations involving Form prevalue sources using XPath. #69​
• Fixed issue with restore options when Forms 8.8 is used with form definitions stored on disk. #76
• Improved reliability of extractions triggered from Umbraco Cloud git deployment operations by introducing a new marker file used only on start-up.

• Improved reliability of extractions on new Cloud infrastructure by wrapping and throttling the file system watcher events.

• Fixed issues with styling and scripts on the custom “no content” page displayed when Deploy is used.

• Fixed issue with language deployment when fallbacks are configured.

• Improved the error reporting when authorization fails between environments (V9 only). #77
• Fixed issue with restore of empty tab alias #84

4.3.0 (October 7th 2021)

• Added support for deployment of CMS tabs and groups

• Fixed issue with JSON detection causing issues using square brackets in grid content #70

4.2.0 (August 19th 2021)

• Added support for deployment of form folders #75 (Forms)
• Added support for backoffice transfer of data from custom packages or solutions

• Provided option for deploying dictionary items "as content" #17 #56
• List multiple dependency errors when deploying or restoring #5
• Add additional detail about deployment errors into logs #40
• Alter structure of .uda files to put name and alias at the top #50
• Fixed issue with removal of used macro parameter when restoring #53
• Add deep-link to deploy dashboard from transfer queue, so will be shown on click from "open transfer queue" (if CMS version supports deep dashboard links) #57
• Added value connector for new media picker #58
• Added refresh button to queue #61
• Fixed issue with changing casing of template aliases #63
• Added clear signature operation for minor updates of Deploy or CMS

• Fixed issue with forms deployment where workflows are deleted via code.

• Fixed issue with deploying Form prevalues with Forms versions < 8.5 #23

4.1.4 (September 7th 2021)

• Resolution of issue with failed extractions on vNext infrastructure.

4.1.3 (August 3rd 2021)

• Resolution of issue with failed extractions on vNext infrastructure.

4.1.1 (April 27th 2021)

• Added serialization converter for control of number of decimal places - #465 (internal)

• Resolved issue with deployment of content schedule - #445 (internal) and #31
• Resolved issue with unnecessary empty records being created in destination database - #444 (internal)

• Resolved issue with transfer of content templates when variants are enabled - #385 (internal)

• Resolved issues with content restore progress not updating when custom dashboards are installed - #39 and #47
• Resolved issue with deployment of changes to default language - #32
• Resolved issue with deployment of empty values not replacing previously entered content - #1
• Removed "transfer now" button from users that don't have permission to "queue for transfer" - #25
• Added deployment of member only property type properties (e.g. "view on profile") - #21
• Cleared pre-values cache on form deployments - #43
• Ensured datatype move action triggered serialization and allows deployment to target environment - #10
• Resolve UI issue where dialog closes if not accurate on selecting node from target environment for restore - #4

4.1.0 (March 25th 2021)

• Management dashboard for triggering and viewing status of deployment operations

• Release of Deploy On-Premises

4.0.1 (March 23rd 2021)

• Enabling Deploy 4 to work in new Cloud infrastructure

Deploy Contrib

10.3.0 (August 15th 2024)

• All items from 10.3.0-rc1

10.3.0-rc1 (July 19th 2024)

• Skip empty pre-values #63
• Add DocTypeGridEditor Data Type configuration connector #65

10.2.0 (March 19th 2024)

• All items from 10.2.0-rc1

10.2.0-rc1 (March 5th 2024)

• Add legacy migrators and type resolver to allow importing from Umbraco 7 in #61

10.1.1 (February 14th 2023)

• Block grid editor support and fix for null reference exception (10+)

• Further caching for deploy operations.

10.1.0 (September 7th 2022)

• Fixed issue with transfer of nested content string values using item templates (which is commencing with "{{") that were erroneously considered as JSON in #56

10.1.0-rc001 (September 7th 2022)

• Updated connectors to use context cache in #54

10.0.1 (July 12th 2022)

• Optimized existence checks in connectors

10.0.0 (June 15th 2022)

• Updated Deploy and CMS dependencies to v10

Version 4

4.4.0 (August 15th 2024)

• All items from 4.4.0-rc1

4.4.0-rc1 (July 19th 2024)

• Skip empty pre-values #63
• Add DocTypeGridEditor Data Type configuration connector #65

4.3.0 (March 16th 2024)

• All items from 4.3.0-rc1

4.3.0-rc1 (March 5th 2024)

• Add legacy migrators and type resolver to allow importing from Umbraco 7 in #61

4.2.1 (February 21st 2023)

• Add additional caching using IContextCache in #59

4.2.0 (September 22nd 2022)

• Fixed issue with transfer of nested content string values using item templates (which is commencing with "{{") that were erroneously considered as JSON in #56

4.2.0-rc001 (September 7th 2022)

• Used caching in value connectors to improve performance.

4.1.3 (July 12th 2022)

• Optimized existence checks in connectors

4.1.2 (April 26th 2022)

• Fixes issue with deployment of nested content properties within Document Type grid editor values in https://github.com/umbraco/Umbraco.Deploy.Contrib/pull/49 (fixes issue #82)

4.1.1 (February 14th 2022)

• Fixes NullReferenceException when parsing Block Editor values without settings

• Reduced Nested Content value connector logging level to debug

4.1.0 (September 17th 2021)

• Added in codes for the DTGE (Doc Type Grid Editor) cell value connector in #39

4.0.0 (May 28th 2021)

• Make ToArtifact/FromArtifact virtual in #47

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.