umbraco-localization

Implement Umbraco backoffice localization with TypeScript and the Extension Registry.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/kraftvaerk/Kraftvaerk.Umbraco.Alchemy --skill umbraco-localization-kraftvaerk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: umbraco-localization
Source: https://github.com/kraftvaerk/Kraftvaerk.Umbraco.Alchemy/tree/main/Kraftvaerk.Umbraco.Alchemy.Frontend/.agents/skills/umbraco-localization
Command: npx skills add https://github.com/kraftvaerk/Kraftvaerk.Umbraco.Alchemy --skill umbraco-localization-kraftvaerk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers understand and implement localization within the Umbraco backoffice, ensuring user interfaces can be translated for different languages.

Core Features & Use Cases

  • Understand Localization Concepts: Learn about localization files, the Extension Registry, and the Localization Controller.
  • Implement Translations: Generate code examples for using built-in and custom translation keys, including pluralization and dynamic values.
  • Use Case: A developer needs to add Danish translations to a custom Umbraco backoffice section. This Skill provides the necessary code snippets and guidance on registering custom localization files.

Quick Start

Fetch the latest documentation on Umbraco localization and generate a TypeScript example for using the localize controller with a custom key.

Frequently Asked Questions about umbraco-localization

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

FAQPage Schema
How do I add custom Danish translations to the Umbraco backoffice?

To add Danish translations to the Umbraco backoffice, you register custom localization files and use the Extension Registry to map custom translation keys for your user interface.

How does the localize controller work for Umbraco internationalization?

The localize controller works for Umbraco internationalization by resolving built-in and custom translation keys, handling dynamic arguments, and managing pluralization for UI translation within TypeScript.

How do I register custom translation keys using the Umbraco Extension Registry?

You register custom translation keys in the Umbraco Extension Registry by defining localization files and invoking the registry to map those keys, which the Localization Controller then resolves for the UI.

Do I need TypeScript and Umbraco Elements to implement backoffice localization?

Yes, you need familiarity with TypeScript and Umbraco Elements to implement backoffice localization, as these are required to integrate the localization files and the Extension Registry within the UI.

Can I handle pluralization and dynamic values in Umbraco localization files?

Yes, you can handle pluralization and dynamic values in Umbraco localization files by configuring argument handling within your custom keys, ensuring the UI translation adapts to variable content.

What is the best way to structure Umbraco localization files for a custom backoffice section?

The best way to structure Umbraco localization files for a custom backoffice section is to define custom keys in dedicated files, register them via the Extension Registry, and retrieve them using the Localization Controller.