Our.Umbraco.Extensions.Localization 1.0.0

Umbraco Localization Extensions

<img src="docs/img/logo.png?raw=true" alt="Umbraco Localization Extensions" width="250" align="right" />

Getting started

This package is supported on Umbraco v10-v13

Installation

Localization Extensions is available via NuGet.

To install with the .NET CLI, run the following command:

$ dotnet add package Our.Umbraco.Extensions.Localization

To install from within Visual Studio, use the NuGet Package Manager UI or run the following command:

PM> Install-Package Our.Umbraco.Extensions.Localization

Usage

Localization Extensions provides some helpful tools for working with localized content in Umbraco.

Backoffice Cultures

When working in a site with multiple cultures defined, Umbraco shows every configured culture as an option on every content item within the CMS.

Localization Extensions filters the list of available cultures to include only those attached to hostnames on the current or ancestor nodes in the tree, allowing greater control over permissions and improving editor experience where many cultures are defined.

If a node already exists in a given culture that culture will always be shown regardless of if a hostname exists. The default and mandatory cultures will also always be shown.

Published Content

Umbraco's Name() returns the name of an IPublishedContent item for the current culture. The NameOrDefault() extension can be used on IPublishedContent to get the node name for the current culture or fallback to the default culture if no value is found.

URL Providers

Umbraco's DefaultUrlProvider returns the URL for a given node in the current culture, or # if that node is not published in the current culture.

The LanguageFallbackUrlProvider will change this behaviour to always return the URL in the current culture or fallback to the URL from the configured fallback or default cultures.

public class Composer : IComposer
{
    public void Compose(IUmbracoBuilder builder)
    {
        builder.UrlProviders().FallbackToLanguage();
    }
}

Contribution guidelines

To raise a new bug, create an issue on the GitHub repository. To fix a bug or add new features, fork the repository and send a pull request with your changes. Feel free to add ideas to the repository's issues list if you would to discuss anything related to the library.

Who do I talk to?

This project is maintained by Callum Whyte and contributors. If you have any questions about the project please raising an issue on GitHub.

Credits

The package logo uses the Globe icon from the Noun Project by il Capitano, licensed under CC BY 3.0 US.

License

Copyright © 2026 Callum Whyte, and other contributors

Licensed under the MIT License.