Umbraco migrations vs transitions

With Umbraco's version 14 released, we want to revisit the question of upgrading or migrating your CMS.

In Enterspeed, we kind of stumbled into the space of migrating CMSs by accident. Our Umbraco and Sitecore source integrations work by sending a copy of each piece of data to Enterspeed. So, basiccaly, you gat 50% of a content migration out of the box.

Of course, the other 50% is to insert the data into a new CMS instance. Working off the idea that we had 50% of the work done, we demoed a Sitecore to Umbraco migration at Codegarden 2022. The component that does the last 50% of the work is an Umbraco extension that loads the data from Enterspeed and creates it as Umbraco document types, nodes, etc.

The issue with migrations

Anyone who's ever worked with migrations knows that it takes more than moving data from A to B. The trickiest part of a migration project is when the source data model doesn't match the target data model and you need to transform the data. When faced with moving data between different CMSs, or even different versions of the same CMS, you also want to leverage the new features from the target CMS, and this also adds to the need for transforming the data. For example, in Umbraco, you might want to migrate from Nested Content to Block List.

Speaking of Umbraco, we want to zoom in on this in the context of Umbraco 14. Third-party data types have been one of the pillars for the success of Umbraco as a CMS platform loved by developers and users. But the consequence is that Umbraco solutions differ in their structure and data types, and the breadth of data types any given migration tool needs to support is large. A migration tool, therefore, needs to be a developer framework that allows the developers to extend and customise the software for each individual migration project.

The status of the Enterspeed migrator

The Enterspeed migrator never took off as a developer framework and didn't reach the scale in regard to supporting all the different variants of Umbraco data types. The main reason was that better alternatives existed for an Umbraco to Umbraco migration. In this context, we want to highlight the uSync Migration project, which has worked on years of development on persisting and moving Umbraco data between different instances. Today, the main focus of the Enterspeed migrator is migrations from other CMSs into Umbraco.

For an example, you can see how one of our customers had a hassle-free CMS migration from Sitecore to Umbraco. 🎉

Transitioning to headless

If your Umbraco migration project involves a transition to headless, we see a few different paths.

1. Tackle the frontend build before you take on the Umbraco migration project. This can make sense if you want to accelerate a new user experience but without actually doing an Umbraco upgrade. This postpones the actual Umbraco migration, as Enterspeed will be the headless API.
   
   
2. Leave your legacy content in the existing Umbraco installation (e.g. if you have a large help section or article archive) and build a new Umbraco project for your new content (e.g. front page, category, or landing pages). Then you can ingest data from both Umbraco installations into Enterspeed and build your new headless website.
   
   
3. Migrate only for the Umbraco back office and the data, and not the frontend templating in Umbraco. The website build is then done headless with Enterspeed as the API layer. Doing the actual migration makes sense if you want to make use of the new features of the CMS, but of course, the project is going to be more substantial.

If you want to know more about transitioning with Enterspeed, you can view our Umbraco Tech Partner webinar on transitioning your legacy CMS.