Umbraco 11.4 Top Hero Dark 1500X500px @2X

Umbraco 12.1 release

Learn all about the the new features available for Umbraco CMS

Rune 1 (2)
Written by Rune Strand

Umbraco 12.1 includes numerous features and tweaks to help improve both the developer and editing experience. Accessibility, UX, localization, performance and more has been improved in this release - let’s take a look 👀



Update 31-08-2023: We unfortunately did not include the Pre- and Post-Routing pipeline filters feature in Umbraco 12.1. It will be available in 12.2 which is targeted for release on September 14 (with RC coming on September 7). Sorry for any inconvenience this may have caused.

What’s new in Umbraco 12.1

Member Type Compositions

Member Types now support the use of compositions. This means you can mix and match the types and be more efficient in setting up and managing installations with a lot of Member Types. Compositions are added in the Member Type editor in the same way as with Document and Media Types.

This brings the functionality for Member Types on par with Document, Element, and Media Types, and will surely be a big help for projects making use of multiple Members Types. Documentation has been updated with the new functionality.

Pre- and Post-Routing pipeline filters

With new pipeline filters, developers have even more control over how middleware is added. This can now be done before or after routing, with the PreRouting and PostRouting filters respectively. More details can be found on the Add PreRouting and PostRouting pipeline filters PR description.

Update 31-08-2023: We unfortunately did not include the Pre- and Post-Routing pipeline filters feature in Umbraco 12.1. It will be available in 12.2 which is targeted for release on September 14 (with RC coming on September 7). Sorry for any inconvenience this may have caused.

A new configuration has been added with this release, making it possible to opt out of indexing nested properties (Block List/Grid, Nested Content) individually in the Examine indexes. This can be done by setting:

The default behavior will be as before, with the value set to true.

You also find a nice addition to the Examine Dashboard making it easier to inspect queries on large data sets.

Umbraco 12.1 Examine Dashboard Information

You will now see the number of returned results, how many are currently displayed, and pagination information at the end of the result list.

Backoffice localization - Pozdrav 👋

The Umbraco backoffice is now translated to Croatian thanks to a great community contribution. This means you can now choose Croatian as the language for backoffice users and the bulk of the interface will be appropriately translated. 

Umbraco 12.1 Cratian Backoffice Localization

There’s also a sizable update to the Swedish backoffice translation, as well as minor tweaks and improvements to Danish, Dutch, and English (EN/US).

Performance enhancements

Logging performance has been optimized by introducing a check on Trace/Debug log level before attempting to call the logger. This optimization should help reduce unnecessary method calls and memory allocations associated with logging, ultimately leading to improved system performance.

Several indexes have been added which will help improve SQL query performance, and finally, some nifty updates to improve Enum performance and ensure the use of built-in parse methods.

And much more…

There’s a whole lot more included in the release. You can see the full list of features, improvements, and fixes in the release notes for Umbraco 12.1. This release really highlights the collaborative nature of Umbraco’s open-source community. Many of the pull requests have multiple reviewers and contributors, not just from the Core Collaborators team but also from other community members and the HQ development team. An impressive 65% of improvements in this release are from the community 🤩 And that’ll work nicely as a segue to 👇

Community Contributions

Of the 60 bug fixes and feature additions in Umbraco 12.1.0, a total of 39 of them have been contributed by the community, by 29 unique contributors.

We’re welcoming 8 brand new contributors who have made their first pull request for Umbraco CMS; they’re marked with a star below. Welcome to the contributor club Marco Teodoro, Martina Ronnysdotter, michiel-sj, Ahmet, Miguel Pinto, Lili Rossiter, alevak09 and Mads Mørch Schou 🏆


Bjarne Fyrstenborg - 7 PRs

⭐ Miguel Pinto - 2 PRs

Russell - 2 PRs

Nuklon - 2 PRs

Paul Seal - 2 PRs

Arkadiusz Biel - 1 PR

Mykyta Zakharov - 1 PR

Ibrahim Muhammad Nada - 1 PR

Chad - 1 PR

⭐ Marco Teodoro - 1 PR

Lucas Bach Bisgaard - 1 PR

Marc Goodson - 1 PR

⭐ Martina Ronnysdotter - 1 PR

Warren Buckley - 1 PR

⭐ michiel-sj - 1 PR

Callum Whyte - 1 PR

⭐ Ahmet - 1 PR

⭐ Lili Rossiter - 1 PR

⭐ alevak09 - 1 PR

Jan Skovgaard - 1 PR

⭐ Mads Mørch Schou - 1 PR

Jason Elkin - 1 PR

Maarten Willebrands - 1 PR

Chris Kim - 1 PR

Dennis Öhman - 1 PR

Anders Bjerner - 1 PR

Nikolaj Brask-Nielsen - 1 PR

Rasmus Söderström - 1 PR

Erik-Jan Westendorp - 1 PR


⭐ = First pull request to Umbraco CMS

And of course, as a thank you, we’ve just added another bunch of trees to our growing plot for today’s 12.1.0 release to celebrate your contributions! 🌳🌲🌴

Umbraco 12.1 Top Hero Dark 1500X500px @2X 80

How to get your hands on Umbraco 12.1

As always, from today, all new Umbraco 12 projects on Umbraco Cloud will be running 12.1. For all our Umbraco Cloud customers with existing projects, the upgrade to the latest version is only 2 minutes away:

We’ve wrapped it all up for you, so all you have to do now is follow these steps:

  • Add a Development Environment to your project, if you do not already have one (Add a Development environment by clicking “Manage Environments” in the project view)
  • Make sure you also restore the content to the Development Environment from your Live.
  • When the Development Environment is all set up and you’ve made sure you don’t have any pending changes on the Development Environment - you are all ready to upgrade to Umbraco 12.1!
  • It's as easy as clicking a button - like, literally clicking the "Upgrade Available" button on the Development Environment. The auto-upgrader will take care of everything from here! 🚀
  • Once it's done, check the Development Environment to make sure everything is looking right.
  • When that's confirmed, you are ready to deploy the upgrade to the next environment, Live or Staging, and start taking full advantage of all the new features.

Non-Cloud and release notes:

As always, installation and release notes can be found on Our: 

This release is also available from Nuget:

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