{"title":"Define tooltips for table and page fields","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-adding-tooltips/","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/devenv-adding-tooltips, 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/devenv-adding-tooltips","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":"Description of how you use AL to add tooltips to table and page fields so that they're available when users hover over fields in the client.","date":"2026-10-06","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Define tooltips for table and page fields","slug":"define-tooltips-for-table-and-page-fields","at":0,"chars":2992},{"level":2,"title":"Adding tooltips to table fields (2024 release wave 1 or later)","slug":"adding-tooltips-to-table-fields-2024-release-wave-1-or-later","at":448,"chars":984},{"level":2,"title":"Overriding tooltips on table fields (2024 release wave 1 or later)","slug":"overriding-tooltips-on-table-fields-2024-release-wave-1-or-later","at":1432,"chars":1029},{"level":2,"title":"Adding tooltips to page fields (2023 release wave 2 or earlier)","slug":"adding-tooltips-to-page-fields-2023-release-wave-2-or-earlier","at":2461,"chars":281},{"level":2,"title":"Related information","slug":"related-information","at":2742,"chars":250}],"text":"# Define tooltips for table and page fields\nEven a well-designed user interface can confuse some users. You can't predict every question, so the base application includes tooltips for all page fields. Tooltips explain what data users can enter and how Business Central uses it. Keep tooltips in mind when you develop your solution's user interface.\nSee Help users get unblocked (by providing tooltips)<../user-assistance#help-users-get-unblocked>.\n## Adding tooltips to table fields (2024 release wave 1 or later)\nStarting in Business Central 2024 release wave 1, you can define tooltips on table fields. When a tooltip is defined on a table field, any page that uses the field automatically inherits the tooltip.\nThe following example shows how tooltips are defined on the table level:\n```al\ntable 50102 MyTable\n{\n    DataClassification = CustomerContent;\n\n    fields\n    {\n        field(1; MyField; Integer)\n        {\n            ToolTip = 'Field number one is always the best!';\n        }\n\n        field(2; MySecondField; Integer) {  }\n    }\n}\n```\n> TIP\n> The AL Language extension for Microsoft Dynamics 365 Business Central for Visual Studio Code includes the CodeCop informational rule AA0234: You should write a tooltip in the Tooltip property for all fields on table objects. Consider enabling the rule if you want to ensure that all fields have a tooltip. Learn more about code analysis in devenv-using-code-analysis-tool.\n## Overriding tooltips on table fields (2024 release wave 1 or later)\nStarting in Business Central 2024 release wave 1, you can define tooltips on table fields. A page field inherits a table field's tooltip unless you define another tooltip on the page field. In that case, the client displays the page field's tooltip.\nThe following example shows how a page field overrides a tooltip defined on a table field:\n```al\npage 50103 MyPage\n{\n    PageType = Card;\n    ApplicationArea = All;\n    UsageCategory = Administration;\n    SourceTable = MyTable;\n\n    layout\n    {\n        area(Content)\n        {\n            group(GroupName)\n            {\n                field(First; Rec.MyField)\n                {\n                    ToolTip = 'This tooltip overwrites the tooltip defined on the table field.';\n                }\n\n                field(Second; Rec.MySecondField)\n                {\n                    ToolTip = 'Tooltip on page field (it was never defined on the table)';\n                }\n            }\n        }\n    }\n}\n```\n## Adding tooltips to page fields (2023 release wave 2 or earlier)\nIn Business Central 2023 release wave 2 or earlier, you can only define tooltips on page fields.\nIf you display a table field on multiple pages, such as a card and a list, you must define the tooltip on each page.\n## Related information\nHelp users get unblocked (by providing tooltips)<../user-assistance#help-users-get-unblocked>\nBuild your first sample extension with extension objects, install code, and upgrade code<devenv-extension-example>\ndevenv-page-object"}