Skip to content

Add Deploy 16 release notes and update version specific upgrade notes #7167

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 7 commits into from
Jun 13, 2025
Merged

Add Deploy 16 release notes and update version specific upgrade notes #7167

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
1a68e9b
Add Deploy 16 release notes
ronaldbarendse Jun 12, 2025
645a563
Update version specific upgrade notes
ronaldbarendse Jun 12, 2025
b4e72f7
Add Forms.Deploy 16 release notes
ronaldbarendse Jun 12, 2025
a3ac7e2
Update 16/umbraco-deploy/release-notes.md
eshanrnh Jun 13, 2025
f0889a8
Update 16/umbraco-deploy/release-notes.md
eshanrnh Jun 13, 2025
c19bdbb
Update 16/umbraco-deploy/upgrades/version-specific.md
eshanrnh Jun 13, 2025
c1beecc
Update 16/umbraco-deploy/upgrades/version-specific.md
eshanrnh Jun 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 36 additions & 1 deletion 16/umbraco-deploy/release-notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
description: Get an overview of the things changed and fixed in each version of Umbraco Deploy.
---

# Release notes
# Release Notes

In this section we have summarised 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.

Expand All @@ -16,6 +16,25 @@ If you are upgrading to a new major version you can find the details about the b

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

### [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
Expand All @@ -28,6 +47,22 @@ This section contains the release notes for Umbraco Deploy 15 including all chan

## Umbraco.Deploy.Contrib

### [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
Expand Down
46 changes: 42 additions & 4 deletions 16/umbraco-deploy/upgrades/version-specific.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,52 @@

#### Entity type registration

Entity type registration is simplified by removing client-side concerns from the server and aligning built-in and custom Umbraco CMS entities (like Forms and Commerce).
Entity type registration is simplified by removing client-side concerns from the server and aligning built-in Umbraco CMS and custom entities (like Forms and Commerce).

Check warning on line 24 in 16/umbraco-deploy/upgrades/version-specific.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).

Raw Output:
{"message": "[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).", "location": {"path": "16/umbraco-deploy/upgrades/version-specific.md", "range": {"start": {"line": 24, "column": 1}}}, "severity": "WARNING"}

* `IDiskEntityService.RegisterDiskEntityType(...)` - This now only requires the entity type, removing the `name`, `isUmbracoEntity` and `installedUdisGetter` parameters.
* `ITransferEntityService.RegisterTransferEntityType(...)` - This is also simplified, removing the `name`, `isUmbracoEntity`, `treeAlias`, `matchesRoutePath`, `matchesNodeId` and `entitiesGetter` parameters.

The name was only used in the backoffice, for example, to group items in the transfer queue and schema comparison dashboard. It now uses localizations (`deploy_entityTypes_{entityType}` or `general_{entityType}`), falling back to the plain entity type.

The `isUmbracoEntity` flag was used in the schema comparison dashboard and for setting signatures to fetch entities differently from custom ones. Making `installedUdisGetter` and `entitiesGetter` mandatory could fetch these items, but this is already possible via service connectors (`IServiceConnector.GetRangeAsync()` and `IServiceConnector.GetArtifact()`).
The name was only used in the backoffice, for example, to group items in the transfer queue and schema comparison dashboard. It now uses localizations (`deploy_entityTypes_{entityType}` or `general_{entityType}`), falling back to the plain entity type if no translation is provided.

The `isUmbracoEntity` flag was used when fetching entities in the schema comparison dashboard and for setting signatures. This could only be enabled for built-in Umbraco entities directly supported by Deploy. Custom entities required providing the `installedUdisGetter` or `entitiesGetter` parameter for these features to work correctly. However, getting all entities is already possible via the service connectors (`IServiceConnector.GetRangeAsync()` and `IServiceConnector.GetArtifact()`), making these parameters redundant.

The `treeAlias`, `matchesRoutePath`, and `matchesNodeId` parameters are removed because the client-side already tracks the entity types. It's recommended to use the same entity types on both the client (in workspaces and routes) and the server (in UDIs, artifacts, and service connectors). If different, Deploy supports mapping the client-side entity types to their server-side counterpart using a `deployEntityTypeMapping` manifest, as shown in the following example:

Check warning on line 33 in 16/umbraco-deploy/upgrades/version-specific.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).

Raw Output:
{"message": "[UmbracoDocs.SentenceLength] Write shorter sentences (less than 25 words).", "location": {"path": "16/umbraco-deploy/upgrades/version-specific.md", "range": {"start": {"line": 33, "column": 138}}}, "severity": "WARNING"}

```json
{
"id": "Umbraco.Commerce.Deploy",
"name": "Umbraco Commerce Deploy",
"version": "16.0.0",
"extensions": [
{
"type": "localization",
"alias": "Uc.Deploy.Localization.En",
"weight": -100,
"name": "English",
"meta": {
"culture": "en",
"localizations": {
"deploy_entityTypes": {
"umbraco-commerce-product-attribute": "Umbraco Commerce Product Attribute",
"umbraco-commerce-product-attribute-preset": "Umbraco Commerce Product Attribute Preset",
}
}
}
},
{
"type": "deployEntityTypeMapping",
"alias": "Uc.Deploy.EntityTypeMapping",
"name": "Umbraco Commerce Deploy Entity Type Mapping",
"entityTypes": {
"uc:product-attribute": "umbraco-commerce-product-attribute",
"uc:product-attributes": "umbraco-commerce-product-attribute",
"uc:product-attribute-preset": "umbraco-commerce-product-attribute-preset",
"uc:product-attribute-presets": "umbraco-commerce-product-attribute-preset"
}
}
]
}
```

### Dependencies

Expand Down
12 changes: 12 additions & 0 deletions 16/umbraco-forms/release-notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,18 @@

This Deploy add-on adds support for transferring, restoring, exporting and importing (including migrating between major versions) of Umbraco Forms data.

### 16.0.0 (June 12th 2025)

Check failure on line 41 in 16/umbraco-forms/release-notes.md

View workflow job for this annotation

GitHub Actions / runner / vale 

[vale] reported by reviewdog 🐶
[UmbracoDocs.Acronyms] 'CSV' has no definition

Raw Output:
{"message": "[UmbracoDocs.Acronyms] 'CSV' has no definition", "location": {"path": "16/umbraco-forms/release-notes.md", "range": {"start": {"line": 41, "column": 64}}}, "severity": "ERROR"}
* Update Forms and Deploy dependencies to 16.0.0

### 16.0.0-rc5 (June 10th 2025)

* Update Forms and Deploy dependencies to 16.0.0-rc5

### 16.0.0-rc4 (June 10th 2025)

* Update Forms and Deploy dependencies to 16.0.0-rc4

### 16.0.0-rc3 (June 3rd 2025)

* Update Forms and Deploy dependencies to 16.0.0-rc3
Expand Down
Loading