Umbraco 10.2 Top Hero Light 1500X500px @2X

Umbraco 10.2 Release

Find out what you get with this brand new version of Umbraco

Bjarke Mikkelsen Berg
Written by Bjarke Berg

Language Variants is a powerful feature for multi-lingual sites that offers one-to-one translations, and side-by-side editing out of the box. With Umbraco 10.2 a number of features combine to give a big boost to how you can customize, tailor and configure Language Variants to produce an even better editing experience. Aside from that, there are numerous tweaks to the UI and UX of Umbraco 10, performance enhancements, and a whole lot more. It might be a minor but it packs a punch - let’s take a look 🥊



What’s new in Umbraco 10.2

Some great new features are available as well as a long list of improvements and fixes.

User Permissions for Languages

New feature adding the ability to limit the language variants an editor has access to. Now it is possible to specify, on User Groups, what languages a user can manage. By default, all existing User Groups allow editing of all languages.

Umbraco 10.2 Permissions For Language Variants 1999X1143px

The languages that you are allowed to manage are reflected in both Content and Translation sections. See the Control User Group permissions on language variants documentation for details.

Improved read-only mode

When a user does not have permission to manage a given language, all Property Editors are shown in read-only mode when looking up that language. Read-only makes it possible to see but not edit content and has been updated to allow for copying. That’s right, you can now copy content that cannot be edited by highlighting text or using property actions such as copying all items from a Media Picker. 

All built-in Property Editors in Umbraco now support read-only.

Read-only mode for Property Editors

Property Editors now have native support for the read-only mode. This can be used by package developers as well with a new configuration option for package manifest. This allows developers to implement support for the new read-only mode and provide the optimal editing experience. If read-only is not implemented, the behavior will be as before with an overlay that makes the content inaccessible. Documentation for this feature is in the works, for now the pull-request for the new features has details that should be helpful.

Editing shared properties across languages

With the introduction of user permissions for languages the behavior of properties that are shared between languages (invariant properties) has also been updated. Shared properties can now be edited and updated from any language, not just the default language.

We have introduced new culture/shared labels on properties to make it more clear where values come from. As it is now possible to edit an invariant value from any language the culture label has been updated to say the property is “Shared” instead of the previous “Inherited from…”

Umbraco 10.2 Save Invariant Properties On All Languages 1999X954px

To edit a shared property the value will have to be "unlocked" to make it clear that this change will affect all languages. See the Allow Edit Invariant From Non-Default documentation for details.

Updated Translation Section

As mentioned above the new user permissions for languages is also reflected in the Translation section. You will now see read-only for languages you don’t have access to on Dictionary Items.

And just as with read-only for Content properties you can still highlight and copy text from all languages. 

Filtering Dictionary Items

To further increase usability in the Translation section it is now possible to filter Dictionary Items similar to what you know from other List Views. 

A search field has been added in the top right corner of the translation section - really useful for sites with a lot of Dictionary items. Thanks to Johannes Lantz for contributing this great piece of functionality 🙌

Changes since the release candidate

There have been a couple of updates since the Umbraco 10.2 release candidate was made available. 

And much more…

There are many more features, improvements, and tweaks included in Umbraco 10.2. 

Developer experience has been boosted by adding extensions to the UmbracoBuilder making the options available much more discoverable. 

A number of accessibility improvements have been added as well as UI/UX tweaks such as an improved Compositions dialog in the Content Type editor.

And of course, the fix for the recent security issue in Umbraco 9 and 10 is also included making Umbraco 10.2 a fantastic release. See the full list of features and enhancements in the release notes.

Community Contributions

Of the 42 bug fixes and feature additions in Umbraco 10.2.0, a total of 21 of them have been contributed by the community, by 15 unique contributors.

We’re welcoming 4 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 Lucas Bach Bisgaard, Ambert van Unen, Tobias Mønster, and Mayur Deore 🏆

Ambert van Unen - 2 PRs

Lucas Bach Bisgaard - 1 PR

Tobias Mønster - 1 PR

Mayur Deore - 1 PR

Tiffany Prosser - 3 PRs

Bjarne Fyrstenborg - 2 PRs

Sven Geusens - 2 PRs

Søren Kottal - 2 PRs

Johannes Lantz - 1 PR

Matthew Care - 1 PR

Paul Woodland - 1 PR

Michael Reiter - 1 PR

Patrick De Mooij - 1 PR

Vitor Rodrigues - 1 PR

Chriztian Steinmeier - 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 10.2.0 release to celebrate your contributions! 🌳🌲🌴

Umbraco 10.2 Top Hero Light 1500X500px @2X

How to get your hands Umbraco 10.2

As always, from today, all new Umbraco 10 projects on Umbraco Cloud will be running 10.2. For all our Umbraco Cloud customers with existing projects, this upgrade 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 10.2!
  • 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:

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 on the community forums.

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