umbraco-localization

Implement Umbraco backoffice localization with translation keys and localized UI text.

1|Updated May 21, 2026
One-click install
npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-localization-1k-off
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-localization
Source: https://github.com/1k-off/umbraco-observability-playground/tree/main/.agents/skills/umbraco-localization
Command: npx skills add https://github.com/1k-off/umbraco-observability-playground --skill umbraco-localization-1k-off

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you translate and manage Umbraco backoffice UI text so your custom elements, dashboards, and manifests can display the right language reliably.

Core Features & Use Cases

  • Use Localize Controller / Localize Element: Retrieve translated strings from extension localization keys and render them in custom UI components.
  • Register custom localization files via Extension Registry: Add new culture-specific dictionaries (for example, en and da) and reference them in manifests.
  • Handle arguments and fallbacks: Support dynamic text (e.g., item counts) and use default values when a key is missing.

Quick Start

Use the Localize Controller to render a translated term like general_welcome in a custom Umbraco backoffice element, and then verify the key via the UmbLocalizationController or umb-localize debug mode.

Frequently Asked Questions about umbraco-localization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I localize custom UI text in the Umbraco backoffice?

To localize custom Umbraco backoffice UI text, you use the Localize Controller or Localize Element to retrieve translated strings from extension localization keys and render them within your custom components.

How do I register custom multi-language translation files in Umbraco?

You register custom multi-language translation files in Umbraco by adding culture-specific dictionaries, such as en and da, to the extension registry and referencing them within your localization manifests.

How does Umbraco handle missing localization keys and dynamic arguments?

Umbraco handles missing localization keys by using termOrDefault to supply fallback values, and supports dynamic arguments within translation keys to display variable data like item counts.

Can I use the extension registry to set up multi-culture dictionaries for Umbraco dashboards?

Yes, you can use the extension registry to set up multi-culture dictionaries for custom Umbraco elements and dashboards, ensuring predictable translated experiences across different cultures.