Dyfort.Umbraco.Migration
13.0.4
dotnet add package Dyfort.Umbraco.Migration --version 13.0.4
NuGet\Install-Package Dyfort.Umbraco.Migration -Version 13.0.4
<PackageReference Include="Dyfort.Umbraco.Migration" Version="13.0.4" />
<PackageVersion Include="Dyfort.Umbraco.Migration" Version="13.0.4" />
<PackageReference Include="Dyfort.Umbraco.Migration" />
paket add Dyfort.Umbraco.Migration --version 13.0.4
#r "nuget: Dyfort.Umbraco.Migration, 13.0.4"
#:package Dyfort.Umbraco.Migration@13.0.4
#addin nuget:?package=Dyfort.Umbraco.Migration&version=13.0.4
#tool nuget:?package=Dyfort.Umbraco.Migration&version=13.0.4
Dyfort.Umbraco.Migration
Umbraco 13 helper package for migrating Nested Content to Block List / Block Grid, both the data type configuration and the stored content.
Endpoints
Both controllers are UmbracoApiControllers, so they are served at /umbraco/api/{Controller}/{Action}. They require a logged-in backoffice user (BackOfficeAccess policy), so open them in the browser while signed in to the backoffice. All are GET and return plain text.
Umbraco 13 has no Management API or Swagger UI (those arrived in Umbraco 14), so these endpoints are not listed in Swagger and this README is the reference.
Recommended order
- Migrate the data types (
DataTypeMigration). - Migrate the content (
Migration).
DataTypeMigration
Converts Nested Content data type configuration. Every Nested Content data type is converted and saved.
| Endpoint | Description |
|---|---|
/umbraco/api/DataTypeMigration/MigrateNestedContentsToBlockEditors |
Data types with exactly one element type become Block List, all others become Block Grid. |
/umbraco/api/DataTypeMigration/MigrateNestedContentToBlockList |
Converts all Nested Content data types to Block List. |
/umbraco/api/DataTypeMigration/MigrateNestedContentToBlockGrid |
Converts all Nested Content data types to Block Grid. |
Example response:
Completed MigrateNestedContentsToBlockEditors. Processed 12 data types, 12 were changed
Migration
Converts stored content values.
| Endpoint | Parameters | Description |
|---|---|---|
/umbraco/api/Migration/MigrateNestedContentToBlocksByDocumentType |
documentTypeAlias, fieldAlias |
Migrates one Nested Content field for every document of the given document type, flips the data type/property to Block List, and rebuilds the published cache. |
/umbraco/api/Migration/MigrateNestedContentsToBlockEditors |
rootId |
Walks the content tree from the node with id rootId and re-saves every Block List / Block Grid property from its Nested Content value. |
Examples:
/umbraco/api/Migration/MigrateNestedContentToBlocksByDocumentType?documentTypeAlias=blogPost&fieldAlias=content
/umbraco/api/Migration/MigrateNestedContentsToBlockEditors?rootId=1050
Example responses:
Completed for document type alias blogPost and alias content. Processed 100 documents, 56 were changed
Result: Success
Document Type Alias: blogPost
...
MigrateNestedContentsToBlockEditors returns one Completed for document type alias ... and alias ... line per document type and property alias found under the root.
Notes:
- "Changed" means the document had at least one value converted. Running the migration again on already-migrated content should report
0 were changed. MigrateNestedContentToBlocksByDocumentTypecan take a long time on large sites, because it saves the document type and rebuilds the cache.- Back up the database before running; the migrations rewrite property data.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net8.0
- Umbraco.Cms.Core (>= 13.0.0 && < 14.0.0)
- Umbraco.Cms.Web.BackOffice (>= 13.0.0 && < 14.0.0)
- Umbraco.Cms.Web.Website (>= 13.0.0 && < 14.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.