Translation
Translation of Business Central extensions using XLIFF files. It covers how layered translation sources override each other by language priority and app dependencies, and how to generate and edit XLIFF files with namespace-aware IDs.
Path: Development > Extension lifecycle > Translation · tier official · system development · narrative reviewed (checked by Opus)
Overview
Translation in Business Central is based on XLIFF files. The overview page explains the layered system: several translation sources can apply at once, and one overrides another according to language priority and app dependencies. It also covers caption translation, primary language fallback, and the global and local language concepts. The page references version 18.3.\n\nThe second page is the hands-on guide. It shows how to generate translation files, add translations, and use namespace-aware IDs to translate UI elements and labels. It refers to the TranslationFile feature, GenerateCaptions, GenerateLockedTranslations, TranslationsWithNamespaces and label syntax. The page references runtime 18.\n\nStart with the overview to understand how languages are layered and which translation wins. Then use the XLIFF guide to set up file generation in your extension.
Key points
- Translations use the XLIFF format.
- Translation sources are layered and can override each other based on language priority and app dependencies.
- Caption translation, primary language fallback, global language and local language are part of the translation model.
- The TranslationFile feature is used to generate translation files for an extension.
- GenerateCaptions, GenerateLockedTranslations and TranslationsWithNamespaces are features related to generating translation files.
- Namespace-aware translation IDs are used to translate UI elements and labels.
- The overview page references version 18.3 and the XLIFF page references runtime 18.
Learn pages
- Translations Overview: An overview of the translation layers of Business Central and the extension model
- Work with XLIFF Translation Files: Learn how to generate, maintain, and package XLIFF translation files for multilingual Business Central extensions, including namespace-aware IDs.
Videos, posts and code changes
Linked by a Haiku matcher with a grounding quote from the item’s summary (link/topics.ts); machine-generated.
- #12062 [Master]-[Quality Management] Workflow events are not localized (code change): “Workflow event labels in the Quality Management app are now properly localized”
- #12097 [29.X]-[Quality Management] Workflow events are not localized (code change): “Event labels for quality workflows now support localization”
- 🚫 Never Publish an AL Extension with Missing Translations Again (community post): “A VS Code extension that validates translation files are present before publishing AL extensions”
Source: Microsoft Learn (CC BY 4.0). Descriptions are Learn’s own.