{"title":"CaptionML Property","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-captionml-property/","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/properties/devenv-captionml-property, 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/properties/devenv-captionml-property","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":"Sets the text string that displays with the object, control, or other element in user interface for the current language.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Applies to","slug":"applies-to","at":182,"chars":414},{"level":2,"title":"Syntax","slug":"syntax","at":596,"chars":88},{"level":2,"title":"Remarks","slug":"remarks","at":684,"chars":1010},{"level":2,"title":"Default Values","slug":"default-values","at":1694,"chars":804},{"level":2,"title":"Related information","slug":"related-information","at":2498,"chars":79}],"text":"> Version: _Available or changed with runtime version 1.0._\nSets the text string that displays with the object, control, or other element in user interface for the current language.\n## Applies to\n Table\n Table field\n Page Field\n Field Group\n Page\n Request Page\n Page Label\n Page Group\n Page Part\n Page System Part\n Page Action\n Page Action Separator\n Page Action Group\n Xml Port\n Report\n Query\n Query Column\n Query Filter\n Enum Value\n Page Custom Action\n Page System Action\n Page File Upload Action\n Page View\n Page Analysis View\n Report Column\n Report Layout\n Profile\n Enum Type\n Permission Set\n## Syntax\n```\nCaptionML = ENU= 'Name',DAN='Navn',ESP='Nombre',FRA='Nom',ENC='Name';\n```\n## Remarks\n> NOTE\n> To submit an app to Marketplace, you must use .xliff translation files. See ../devenv-work-with-translation-files.\nThe CaptionML property is multilanguage enabled, so it can contain a list of text strings in different languages. The string that is used is selected according to the user's language settings. See ../devenv-work-with-translation-files.\nThe CaptionML property has the following format.\n`<Language ID>='<caption>'`\n`<Language ID>` is the standard Windows three-letter language ID, and `<caption>` is the caption text for this language. Use commas to separate entries.\nThe following example shows a CaptionML value.\n`CaptionML = DEU='Name',DAN='Navn',ESP='Nombre',FRA='Nom',ENC='Name';`\nIn this example, values are set for Danish (DAN), German Standard (DEU), Spanish Traditional Sort (ESP), French Standard (FRA), and English Canadian (ENC).\n> NOTE\n> On Role Center type pages, the CaptionML property value is used as the display name for the associated Profile in the client.\n## Default Values\nWhen the CaptionML property does not include an entry for the language used in the client at runtime, then a default value for the caption string will be used according to the following:\n1. If there is an ENU entry, then its caption string is used.\n2. If there are no language entries in CaptionML property, then the caption string is determined according to the following table:\n Object, control, or other element|Default caption\n Table object|Name property\n Table Field|Name property\n Report|Name property\n XMLport|Name property\n Codeunit|Name property\n Menu button and menu item|Name property\n Page objects and page controls (container, group, part, and field)|Name property\n Query objects|Name property\n Query columns|CaptionML property of the underlying table field for the column\n## Related information\ndevenv-caption-property\nName Property<devenv-properties>"}