{"title":"Translations Overview","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-translations-overview/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-translations-overview, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/devenv-translations-overview","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"An overview of the translation layers of Business Central and the extension model","date":"2021-06-15","meta":{"topic":"overview"},"outline":[{"level":2,"title":"The life of a caption","slug":"the-life-of-a-caption","at":434,"chars":526},{"level":2,"title":"Translations in the same layer","slug":"translations-in-the-same-layer","at":960,"chars":819},{"level":2,"title":"Translations in different layers","slug":"translations-in-different-layers","at":1779,"chars":686},{"level":2,"title":"Picking the language to display","slug":"picking-the-language-to-display","at":2465,"chars":1588},{"level":2,"title":"Related information","slug":"related-information","at":4053,"chars":94}],"text":"Your Business Central app can be translated to other languages to adjust it to the market need. Because of the layered architecture of the extension model, the translation(s) that are displayed to the user depends on a number of things as explained in this topic.\nIn Business Central translations are done using XLIFF files, which is a standardized format used for computer-based translations. See devenv-work-with-translation-files.\n## The life of a caption\nTranslations can be applied using multiple properties, and there are multiple opportunities to change them. The caption of a page, for example, can be changed from multiple places. With that flexibility, a defined structure is in place and a page name, for example, will be translated (overwritten) as follows:\n1. Page Name\n2. Page Caption\n3. Page Extension Caption\n4. Translation app\n5. Page Customization\n> NOTE\n> Translations provided using profile configuration cannot be overwritten by any apps.\n## Translations in the same layer\nIf there are multiple translations on the same layer, then it is possible to control which translations are applied last by setting a dependency in the app.json file to the app on the layer where the translation is intended to be applied last.\nFor example, if you want to change the text provided from Translation app XYZ, you can create another translation app, and in the app.json file of that new translation app, you must then specify a dependency on Translation app XYZ to make sure that the translation in the new app is applied after and thereby overwrites the original translation.\n```al\n\"dependencies\":\n  [\n    {\"id\": \"f1f12588-13cb-47fd-b94a-cddce44e9a8f\", \"name\": \"Translation app XYZ\", \"publisher\": \"Default publisher\", \"version\": \"1.0.0.0\"}\n  ]\n```\nSee devenv-json-files.\n## Translations in different layers\nWhen Business Central is extended more layers for translation are typically introduced. A layer can come from extensions and/or from a translation app. When translations from different layers are picked up, one translation from each observed culture is kept and when it is overwritten, only the specified culture changes. The following image illustrates an example of three different layers of translations. A base object, an extension object, and a language app all contribute with languages/translation and the result illustrates how the base object and extension object translations are overwritten by the language app.\n![Translation Overwrites.]\n## Picking the language to display\nOnce translations on the different layers have been collected, the translations that display on the user interface are then picked, based on the context. The illustration below uses the following definitions:\nLocal language\nThe language that the user specifies in Business Central under Settings.\nGlobal language\nBy default it is the same as the local language, but the global language can be changed from AL code.\nDefault Language\nIs defined by a server setting for Business Central on-prem. For Business Central online it is set to the same language that was selected when signing up for Business Central.\nPrimary language (global or local)\nDefined as the primary culture of a language. For `es-MX` (Spanish-Mexico), for example, the primary language will be `es-ES` (Spanish-Spain).\nField Caption\nIf the page control is based on a table field, and if no translations are found on the page, then the translation found on the table field is used.\nThe illustration shows examples of how translations for a page caption, a control caption, an enum caption, and a text constant are found. The search is sequential and starts at number 1, and stops searching when the first translation is met. So, if you, for example, have an enum and no translations are found for the local language or the primary local language, the search stops at the global language because a match is found, and will use that translation in the UI.\n> NOTE\n> For Enum Caption an additional search marked with *) in the above illustration is added with Business Central version 18.3.\n## Related information\ndevenv-work-with-translation-files\nproperties/devenv-captionml-property"}