umbraco-localization

Implement Umbraco backoffice localization with Extension Registry manifests and Localize APIs.

4|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-localization-albanistrefi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-localization
Source: https://github.com/albanistrefi/umbraco_CLI/tree/main/skills/foundation/umbraco-localization
Command: npx skills add https://github.com/albanistrefi/umbraco_CLI --skill umbraco-localization-albanistrefi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you understand and correctly implement localization in the Umbraco backoffice so your UI strings are translated reliably and fallback behavior works as expected.

Core Features & Use Cases

  • Use Localize correctly in Umbraco Elements: Generate translated UI text via the Localize Controller (and support fallback where available).
  • Create and register custom localization files: Define language bundles (for example en.js) and expose them through an Extension Registry manifest.
  • Compose translation keys with arguments: Use parameterized keys to render dynamic, translated strings (including pluralization-ready patterns in your data model).

Quick Start

Fetch the latest Umbraco localization documentation, then implement a custom English localization file and register it via the Extension Registry so your components can render translated keys like myExtension_welcomeMessage.

Frequently Asked Questions about umbraco-localization

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

FAQPage Schema
How do I add UI translations to an Umbraco backoffice extension?

To add Umbraco backoffice UI translations, you create language files like `en.js` and register them through an Extension Registry manifest so your components can consume localized keys.

How does fallback behavior work for Umbraco UI localization keys?

Umbraco UI localization fallback works by mapping keys to language files via the Localize controller and element APIs, ensuring translated text renders predictably even when specific cultures are missing.

Can I use argument-based translation keys in Umbraco Elements?

Yes, you can compose parameterized translation keys in Umbraco Elements to render dynamic, translated strings, allowing you to pass arguments into your localized UI text data model.

What is the best way to register custom localization files in Umbraco?

The best way to register custom Umbraco localization files is by defining language bundles and exposing them via an Extension Registry manifest, which maps translation keys to the correct language files.

Do I need to fetch Umbraco localization docs before implementing i18n?

Yes, you need to fetch the latest Umbraco localization documentation and use web retrieval for authoritative guidance to correctly implement manifest-driven localization bundles across multiple cultures.