Share via

CaptionML Property

Sets the string that is used to identify a control or other object in the user interface.

Applies To

  • Codeunit objects

  • XMLport objects

  • 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

  • Report objects

  • Table objects and table fields

  • XMLport objects


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>=<caption>

<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.


In this example, values are set for Danish (DAN), German Standard (DEU), Spanish Traditional Sort (ESP), and French Standard (FRA).

You can enter values for the CaptionML property in two ways:

  • If you enter a value for the Caption Property, then the CaptionML property is set to the value of the current language. For example, if the current system language is Danish, then a value of DAN =<value> is placed in the CaptionML field.

  • If you choose the AssistButton in the CaptionML value field, then the Multilanguage Editor opens and displays two columns: Language and Value. The Language column is populated with all languages that are defined by Windows. You specify the CaptionML value for a language by entering a value in the Value field for that language. You must close the Multilanguage Editor by choosing OK. If you press ESC to close the Multilanguage Editor, then the CaptionML field is not updated.

When you export objects as XML, the CaptionML property values are included.


For query columns, when you run the query from Object Designer, the About This Query window that opens in the RoleTailored client displays the value for the Name Property of the query column, not the CaptionML Property.

Default Values

The following table shows how the default caption is determined for the various objects in Microsoft Dynamics NAV.

Object, control, or other element Default caption

Table object

Name property

Table Field

Name property


Name property


Name property


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

See Also


Caption Property
Name Property