Sets the string that is used to identify a control or other object in the user interface.
To submit an app to AppSource, you must use .xliff translation files. For more information, see Working with Translation Files.
Menu objects, menu buttons, menu groups, and menu items
Pages, including general page properties and Group, Part, and Field controls.
Query objects and query columns
Table objects and table fields
The 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. For more information, see Multilanguage Development.
The CaptionML property has the following format.
<Language ID> is the standard Windows three-letter language ID, and
<caption> is the caption text for this language. Use semicolons to separate entries.
The following example shows a CaptionML value.
CaptionML = DAN='Navn',DEU='Name',ESP='Nombre',FRA='Nom';
In this example, values are set for Danish (DAN), German Standard (DEU), Spanish Traditional Sort (ESP), and French Standard (FRA).
On Role Center type pages, the CaptionML property value is used as the display name for the associated Profile in the client.
The following table shows how the default caption is determined for the various objects in Dynamics 365 Business Central.
|Object, control, or other element||Default caption|
|Table object||Name property|
|Table Field||Name property|
|Menu button and menu item||Name property|
|Page objects and page controls (container, group, part, and field)||Name property||Query objects||Name property|
|Query columns||CaptionML property of the underlying table field for the column|