We have moved!
You are currently looking at documentation for Umbraco 8 and older versions.
Go to docs.umbraco.com for documentation for Umbraco 9 and newer versions.
Language Variants allows you to vary content by culture, so you can allow a content node to exist in several languages.
This article will cover the different aspects of enabling and working with language variants on your Umbraco website.
- Video tutorial
- How to enable Language Variants
- Enabling Language Variants on Document Types
- Working with Language Variants on content
- Test your language variants
- Control User Group permissions on language variants
- Read more
How to enable Language Variants
To work with Language Variants you need to have more than one language enabled. This can be done from the
You will always have one default language but each language can be set to mandatory.
Enabling Language Variants on Document Types
Now that there are two languages to vary the content with, it needs to be enabled on the Document Types. To do so:
- Go to the document type in the Settings section.
- Open the Permissions page.
- Toggle Allow vary by culture.
To allow a property on the Document Type to be varied it will have to be enabled for the property:
Working with Language Variants on content
When you return to your content node you will notice two things:
At the top of the Content tree there will now be a dropdown so you can show the Content tree in the language of your choice.
To the right of the content name there is now a dropdown where you can select a language. You can also open a split view so you can see two languages at once.
Each Property Editor that does not allow variants (an Invariant Property) will by default need to be unlocked in order to be edited. The lock exists to make it clear that this change will affect more languages, as the value of the invariant properties are shared between all variants on the website.
Whether or not the lock is enabled on the invariant properties depends on the
AllowEditInvariantFromNonDefault setting in the
For projects created on Umbraco version 10.2 or later, the setting is
true, by default. If the project is upgraded to version 10.2 or later, the setting will by default be
Learn more about the
AllowEditInvariantFromNonDefault setting in the Security Settings article.
To read about how you render variant content in Templates, check out the rendering content section.
Test your language variants
Culture and hostnames must be added to your language sites before the content can be tested for variants:
Right-click the Home node and select Allow access to assign culture and hostnames....
In Umbraco v9, this option is called Culture and Hostnames.
Add a specific URL per language and save. For eg: An English language variant with English (United States) as the language can be given a specific URL https://yourwebsite.com/en-us and a Danish language variant can be given a specific URL https://yourwebsite.com/dk.
The Info content app should now show specific URLs for your language variants.
Control User Group permissions on language variants
This feature is available from Umbraco version 10.2.
When you are working with a multilingual site you might want to control who can edit the different variations of the content on the website.
This can be controlled on a User Group level. All default User Groups, except the Sensitive data group, have access to all languages out of the box.
When "Allow access to all languages" is not checked, languages can be added and/or removed in order to control which variations the users in the User Group have access to.
Even though a the language permissions have been set on a User Group, a user in that group will still be able to view and browse all the language variations in the allowed parts of the Content tree. The permission setting will ensure that only the added languages are editable by users of the User Group.