Umbraco9 Rocket Light

Migrating from Umbraco 8 to Umbraco 9

What will migrating your existing site from Umbraco 8 to Umbraco 9 mean for you?

Umbraco 9 came with a lot of exciting news and change - after all, it is the first Umbraco major version to move into the ASP.NET Core world! 🚀

At the same time, it brings a lot of curiosity and questions. Especially from those who would like to wave goodbye to the Umbraco 8 they knew and loved and migrate their existing site to Umbraco 9 so they can get to know and love it, too.

Let us take you through the migration process from version 8 to version 9 - and everything else you need to know about the transition!

How do I upgrade from Umbraco 8 to Umbraco 9?

There’s no way to directly upgrade your site from Umbraco 8 to Umbraco 9 - but you can migrate.

This is because with the transition to version 9, Umbraco is also moving from the ASP.NET framework to ASP.NET Core. Plus, the codebase has been significantly updated in the latest major version. These exciting changes make a direct upgrade button impossible.

But that doesn’t mean you will have to start from scratch! We didn’t build the new major from the ground up - bit by bit, we migrated it to .NET Core. You can migrate the content of your version 8 sites running on the .NET framework to Umbraco 9 running on .NET 5. This also applies to your projects on Umbraco Cloud.

If you are working with Umbraco Heartcore and Umbraco Uno, we’ll automatically upgrade your projects later on.

Dark (Blog Post 900X600)

How do I migrate my existing site to Umbraco 9?

The rule of thumb is that you can migrate all of your projects to the new major. However, the difficulty of the migration depends on the complexity of your v8 site and how tightly it is coupled with the .NET framework.

You can migrate your content by making a backup of the database from your version 8 project, and then restoring it into a new database on a newly-created Umbraco 9 site. Your content will work on version 9. This is possible because the database schema hasn’t changed significantly between the versions.

We have created a basic migration guide for your projects on Umbraco Cloud and Umbraco CMS. Some of the terminology in the guide is Cloud-specific, but the overall approach applies to non-cloud sites, as well.

See the migration guide

Psst... What happens to my packages?

You need to make sure your packages and other dependencies you used on your Umbraco 8 site work with Umbraco 9 - and .NET 5.

All Umbraco HQ packages are ready for Umbraco 9, and many external packages are already available, too. But you should check their status case by case.

It may be necessary to look for alternatives that are compatible with .NET 5 - an example being Nuget packages for specific .NET features.

You can also reach out to the package creator directly for their plan to upgrade to version 9.

Umbraco Package with ribbon icon

Should I migrate my site from Umbraco 8 to Umbraco 9?

Yes! We would recommend you migrate if it’s something that’s possible for you.

Why? Umbraco 9 is better than the previous major versions. Migrating to the .NET Core framework brings better runtime performance, more powerful scalability, and cleaner architecture, among other things that you can look forward to.

What’s more, Umbraco 9 is the new official version of Umbraco, and we will focus all feature development on this major. It will also follow the same minor release cadence that we’ve used with Umbraco 8. This means that new features and fixes will be available for you on Umbraco 9 every six weeks.

It is also the start of a new release cadence for major versions. Going forward we plan to ship two major versions of Umbraco each year. The releases will be aligned with Microsoft’s release cadence for .NET ensuring that you’re always running on the latest, fastest, and most secure version of both Umbraco and the underlying framework.

Umbraco Support Icon

Can I still use Umbraco 8?

Yes.

We will eventually stop supporting the previous major version, but that won’t happen for a while - if you decide to stay on Umbraco 8, you will be supported and safe for quite some time going forward. This is because we’ve decided to consider the last minor release of Umbraco 8 as LTS (long-term support).

That means the final minor version of version 8 will be supported for 24 months after release (the date is TBD - we’ll let you know about this in our future Product Update blog posts). After that, it will enter an additional year of security-only, and at the end of it, Umbraco 8 will be considered end of life.

What’s new in Umbraco 9?

.NET 5

Of course, the biggest change in the transition from Umbraco 8 to Umbraco 9 is the move from ASP.NET to ASP.NET Core. We’re proud to say that Umbraco 9 is running 100% on the ASP.NET Core framework and .NET 5, Microsoft’s latest major release!

But we did not want to change the friendly CMS you know and love too much. So especially for content editors, logging into the version 9 backoffice will be just like coming home as the focus with Umbraco 9 remained on friendly editing experience.

Cross-platform capabilities

Umbraco is no longer only available for Windows users for development or hosting. ASP.NET Core and .NET 5 are cross-platform compatible with MacOs and Linux, too! This opens Umbraco to two entirely new developer bases.

Cross Platform .Com (1000X711)

Improved Cloud projects

Good news: even with Umbraco’s move to .NET Core, the cool features that you are used to - such as one-click installs, multiple environments with built-in schema and content synchronization, or automatic upgrades - are staying.

Better news: you’ll get all the perks of a CMS with better performance. Plus, we took the migration as an opportunity to improve Umbraco Cloud projects! So what’s new on Cloud?

  • Access to using .NET 5 command line tools to manage, build and run your project locally
  • Easier set up of a Visual Studio solution - and easier collaboration with your colleagues
  • Deployments relying on .NET build steps and NuGet for a better and safer experience

Take a look at everything you can look forward to with Umbraco 9 on Cloud in this blog post.


Would you like to dip your feet in Umbraco 9 before migrating your site? Then you can test the waters with an Umbraco Cloud trial - completely for free!

All it takes is a couple of minutes to get it up and running, and then you’re free to explore the ins and outs of Umbraco 9! Hopefully, you’ll be on cloud nine 😉

Try out Umbraco 9 on Cloud

Loved by developers, used by thousands around the world!

One of the biggest benefits of using Umbraco is that we have the friendliest Open Source community on this planet. A community that's incredibly pro-active, extremely talented and helpful.

If you get an idea for something you would like to build in Umbraco, chances are that someone has already built it. And if you have a question, are looking for documentation or need friendly advice, go ahead and ask the Umbraco community on Our.

Want to be updated on everything Umbraco?

Sign up for the Umbraco newsletter and get the latest news and special offers sent directly to your inbox