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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Dyfort.Umbraco.Migration" Version="13.0.4" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Dyfort.Umbraco.Migration" Version="13.0.4" />
                    
Directory.Packages.props
<PackageReference Include="Dyfort.Umbraco.Migration" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Dyfort.Umbraco.Migration --version 13.0.4
                    
#r "nuget: Dyfort.Umbraco.Migration, 13.0.4"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Dyfort.Umbraco.Migration@13.0.4
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Dyfort.Umbraco.Migration&version=13.0.4
                    
Install as a Cake Addin
#tool nuget:?package=Dyfort.Umbraco.Migration&version=13.0.4
                    
Install as a Cake Tool

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.

  1. Migrate the data types (DataTypeMigration).
  2. 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.
  • MigrateNestedContentToBlocksByDocumentType can 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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
13.0.4 77 11/17/2026
13.0.3 89 11/12/2026
13.0.2 119 9/15/2026
13.0.1 140 7/22/2026
13.0.0 140 5/20/2026