description |
---|
This document covers specific upgrade steps if a version requires them. Most versions do not require specific upgrade steps and you will be able to upgrade directly from your current version. |
{% hint style="warning" %} This page is a work in progress. It will be updated as the software evolves. {% endhint %}
Use the information below to learn about any potential breaking changes and common pitfalls when upgrading your Umbraco CMS project.
If any specific steps are involved with upgrading to a specific version they will be listed below.
Use the general upgrade guide to complete the upgrade of your project.
Umbraco 14
Below you can find the list of breaking changes introduced in Umbraco 14 CMS.
- Angular removed: A new backoffice built with Web Components, Lit, and fueled by the Umbraco UI Library
- Icons in the new backoffice are based on Lucide.
- Full TypeScript support for the Backoffice and all its APIs through a public npm package
- A management API documentation in Swagger - replacement for Controllers that were not restful
- Migration from Newtonsoft.Json to the System.Text.Json which removes Nested Content and Grid value converter and so on
- Nested Content and Grid Layout have been removed
- Legacy media picker has been removed
- Macros and Partial View Macros have been removed. Use partial views and/or blocks in the Rich Text Editor.
- XPath has been removed. An alternative is using the Dynamic Roots in the Multinode Treepicker and for ContentXPath the alternative is IContentLastChanceFinder.
- package-manifest is now umbraco.package.json
- Smidge has been removed from default installation along with RuntimeMinification setting. Smidge can be manually installed if needed and you can read the Smidge documentation on how to setup a similar setting to RuntimeMinification.
UmbracoApiController
has been removed and replaced withUmbracoManagementApiControllerBase
- New login screen with possibility to change it and make it customizable
- Light, Dark or Contract Mode option has been added in the backoffice. You can choose your preffered mode from your profile information.
- UI Library and UI API external documentations.
In-depth and further breaking changes for v14 can be found on the CMS Github repository and on Our Website.
Umbraco 14 RC Versions
Below you can find the list of breaking changes introduced in Umbraco 14 RC release versions.
RC 3
RC 2
RC 1
First RC release - 17th of April. Breaking changes since Beta 3:
Umbraco 14 Beta Versions
Below you can find the list of breaking changes introduced in Umbraco 14 Beta release versions.
Beta 3
Beta 2
There are a few breaking changes since Beta 1. Most of the changes concern property editors and getting them to work with migrations as well as new values.
Beta 1
Official release of Beta, 6th March 2023.