{"title":"ToolTip Property","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-tooltip-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-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.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/properties/devenv-tooltip-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 string used for the tooltip of the page.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Applies to","slug":"applies-to","at":290,"chars":524},{"level":2,"title":"Parameters","slug":"parameters","at":814,"chars":362},{"level":2,"title":"Remarks","slug":"remarks","at":1176,"chars":2618},{"level":2,"title":"Related information","slug":"related-information","at":3794,"chars":391}],"text":"> Version: _Available or changed with runtime version 18.0._\nSets 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.\n## Applies to\n Page\n Page Label\n Page Field\n Page Part\n Page System Part\n Page Chart Part\n Page Action Area\n Page Action\n Page Action Group\n Page Custom Action\n Page System Action\n Page File Upload Action\n Page Analysis View\n Report\n Report Column\n Query Column\n Table field\n> NOTE\n> List page field tooltips are only shown in the Web client and Tablet client.\n> NOTE\n> Activity button tooltips are only shown in the Web client.\n> NOTE\n> ActionContainers tooltips are only shown in the Web client for the subtype Embedding.\n## Parameters\nLocked\nType: ../methods-auto/boolean/boolean-data-type\nIf true the ToolTip is locked and should not be translated.\nComment\nType: ../methods-auto/text/text-data-type\nDescriptive text for the ToolTip, for example, with regards to translation.\nMaxLength\nType: ../methods-auto/integer/integer-data-type\nSets the maximum length of the specific ToolTip.\n## Remarks\nThe 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.\nWith 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 `...`.\n> NOTE\n> 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.\n> NOTE\n> With runtime version 14.0, the ToolTip property is available for query columns.\n> NOTE\n> 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>.\nThe following example illustrates how you can apply tooltips in an app:\n```al\nfield(\"Reward ID\";\"Reward ID\")\n{\n    ApplicationArea = All;\n    ToolTip = 'Specifies the level of reward that the customer has at this point.';\n}\n```\nOr, with parameters:\n```al\nfield(\"Reward ID\";\"Reward ID\")\n{\n    ApplicationArea = All;\n    ToolTip = 'Specifies the level of reward that the customer has at this point.', Locked = true, Comment = 'Keep like this, do not translate.', MaxLength = 100;\n}\n```\nThe following example shows how to set a tooltip at the page object level. Navigation actions targeting this page inherit the tooltip automatically:\n```al\npage 50100 MyPage\n{\n    ToolTip = 'Opens the My Page page.';\n    Caption = 'My Page';\n    PageType = Card;\n    // ...\n}\n```\n## Related information\nUser assistance model<../../user-assistance>\n../../user-assistance#guidelines-for-tooltip-text\nConfiguring the help experience<../../deployment/configure-help>\ndevenv-tooltipml-property\nBuild your first sample extension with extension objects, install code, and upgrade code<../devenv-extension-example>\nMultilanguage development<../devenv-work-with-translation-files>"}