# ToolTip Property
> Version: _Available or changed with runtime version 18.0._
Sets the string used for the tooltip of the page. This is only used when the page is the target RunObject of an action - the action will inherit the tooltip of the page if no tooltip is explicitly specified on the action itself.
## Applies to
 Page
 Page Label
 Page Field
 Page Part
 Page System Part
 Page Chart Part
 Page Action Area
 Page Action
 Page Action Group
 Page Custom Action
 Page System Action
 Page File Upload Action
 Page Analysis View
 Report
 Report Column
 Query Column
 Table field
> NOTE
> List page field tooltips are only shown in the Web client and Tablet client.
> NOTE
> Activity button tooltips are only shown in the Web client.
> NOTE
> ActionContainers tooltips are only shown in the Web client for the subtype Embedding.
## Parameters
Locked
Type: ../methods-auto/boolean/boolean-data-type
If true the ToolTip is locked and should not be translated.
Comment
Type: ../methods-auto/text/text-data-type
Descriptive text for the ToolTip, for example, with regards to translation.
MaxLength
Type: ../methods-auto/integer/integer-data-type
Sets the maximum length of the specific ToolTip.
## Remarks
The default is an empty string, which means there will be no tooltip. According to the user assistance model for Business Central, apps are expected to apply tooltips to controls on pages. Tooltips can be up to 1024 characters long, exceeding this doesn't throw an error, but the rest of the tooltip is truncated `...`. The best practice is to not exceed 200 characters. See ../../user-assistance#guidelines-for-tooltip-text.
With the Locked parameter, you can specify that the tooltip shouldn't be translated. This is useful when the tooltip is a technical term or a proper name, for example. The Comment parameter is used to provide additional information about the tooltip, for example, to explain why the tooltip shouldn't be translated. The MaxLength parameter is used to specify the maximum length of the tooltip. If the tooltip exceeds the maximum length, the rest of the tooltip is truncated `...`.
> NOTE
> With runtime version 18.0, the ToolTip property can be set at the page object level. When a navigation action has `RunObject = page X` and the target page has a ToolTip set, the action inherits the page's tooltip if no tooltip is explicitly specified on the action itself. This mirrors the existing behavior for reports.
> NOTE
> With runtime version 14.0, the ToolTip property is available for query columns.
> NOTE
> With runtime version 13.0, the ToolTip property is available for table fields. A table field tooltip will, like the caption, be applied on page controls that reference the table field. This allows you to specify the tooltip in one place and have it applied to all controls that reference the table field. With runtime 13.0, there's a new code action to help move the tooltip from page controls to table fields or clean them up from the page in case of duplicates. See AL code actions<../devenv-code-actions>.
The following example illustrates how you can apply tooltips in an app:
```al
field("Reward ID";"Reward ID")
{
    ApplicationArea = All;
    ToolTip = 'Specifies the level of reward that the customer has at this point.';
}
```
Or, with parameters:
```al
field("Reward ID";"Reward ID")
{
    ApplicationArea = All;
    ToolTip = 'Specifies the level of reward that the customer has at this point.', Locked = true, Comment = 'Keep like this, do not translate.', MaxLength = 100;
}
```
The following example shows how to set a tooltip at the page object level. Navigation actions targeting this page inherit the tooltip automatically:
```al
page 50100 MyPage
{
    ToolTip = 'Opens the My Page page.';
    Caption = 'My Page';
    PageType = Card;
    // ...
}
```
## Related information
User assistance model<../../user-assistance>
../../user-assistance#guidelines-for-tooltip-text
Configuring the help experience<../../deployment/configure-help>
devenv-tooltipml-property
Build your first sample extension with extension objects, install code, and upgrade code<../devenv-extension-example>
Multilanguage development<../devenv-work-with-translation-files>

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-tooltip-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. https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-tooltip-property/
