{"title":"Page object","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-page-object/","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-page-object, 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-page-object","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 the page object and its syntax in AL for Business Central.","date":"2024-04-26","meta":{"topic":"how-to"},"outline":[{"level":2,"title":"Page syntax","slug":"page-syntax","at":1223,"chars":739},{"level":2,"title":"Snippet support","slug":"snippet-support","at":1962,"chars":405},{"level":2,"title":"Add tooltips on page fields","slug":"add-tooltips-on-page-fields","at":2367,"chars":298},{"level":2,"title":"Views","slug":"views","at":2665,"chars":256},{"level":2,"title":"Page example","slug":"page-example","at":2921,"chars":1084},{"level":2,"title":"Related information","slug":"related-information","at":4005,"chars":485}],"text":"Pages are the main way to display and organize visual data in Business Central. They are the primary object that a user will interact with and have a different behavior based on the type that you choose. Pages are designed independently of the device they are to be rendered on, and in this way the same page can be reused across phone, tablet, and web clients.\nWhen developing a solution for Business Central, you follow the code layout for a page as shown in the page example below, but for more details on the individual controls and properties that are available, see properties/devenv-page-property-overview.\nIf you want to, for example, add functionality to a page that already exists in Business Central, you can create a page extension object that changes an existing page object. See Page extension object<devenv-page-ext-object>. Depending on how much you want to change on an existing page, you can also create a page customization object, which offers modifications on actions and layout. See devenv-page-customization-object.\n> IMPORTANT\n> Only pages with the properties/devenv-extensible-property set to true can be extended.\n> NOTE\n> Extension objects can have a name with a maximum length of 30 characters.\n## Page syntax\nThe structure of a page object is hierarchical and breaks down into three sections:\n The first block contains metadata for the overall page; the type of the page and the source table it's showing data from.\n The next section; the layout, describes the visual parts on the page.\n The final section details the actions that are published on the page.\nThe order in which the sections appear matters. The following example illustrates the ordering:\n```al\npage ObjectId PageName\n{\n    // page properties such as\n    PageType = Card;\n    SourceTable = Customer;\n    ContextSensitiveHelpPage = 'my-feature';\n\n    layout {}\n\n    actions {}\n\n    views {} // only for pages of type ListPage\n\n    // optionally, add AL code here\n}\n```\n## Snippet support\nTyping the shortcut tpage will create the basic layout for a page object when using the AL Language extension for Microsoft Dynamics 365 Business Central in Visual Studio Code.\n> TIP\n> Use Ctrl+Space to trigger IntelliSense and get assistance on code completion, parameter info, quick info, and member lists. For more information about snippets, see Syntax and snippets<devenv-syntax>.\n## Add tooltips on page fields\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.\nSee Add tooltips to table and page fields<devenv-adding-tooltips>.\n## Views\nViews in Business Central are used on list pages to define a different view of the data on a given page. Views can be defined for devenv-page-object, Page extensions<devenv-page-ext-object>, and devenv-page-customization-object. See devenv-views.\n## Page example\n```al\npage 50101 SimpleCustomerCard\n{\n    PageType = Card;\n    SourceTable = Customer;\n    ContextSensitiveHelpPage = 'my-feature';\n\n    layout\n    {\n        area(content)\n        {\n            group(General)\n            {\n                field(\"No.\"; \"No.\")\n                {\n                    ApplicationArea = All;\n                    CaptionML = ENU = 'Hello';\n\n                    trigger OnValidate()\n                    begin\n                        if \"No.\" < '' then\n                            Message('Number too small')\n                    end;\n                }\n\n                field(Name; Name)\n                {\n                    ApplicationArea = All;\n                }\n                field(Address; Address)\n                {\n                    ApplicationArea = All;\n                }\n            }\n        }\n    }\n    actions\n    {\n        area(Navigation)\n        {\n            action(NewAction)\n            {\n                ApplicationArea = All;\n                RunObject = codeunit \"Document Totals\";\n            }\n        }\n    }\n}\n```\n## Related information\nAL development environment<devenv-reference-overview>\ndevenv-views\nAdding help links from pages, reports, and XMLports<devenv-adding-help-links-from-pages-tables-xmlports>\nPage extension object<devenv-page-ext-object>\nPage, page fields, and page extension properties<properties/devenv-page-property-overview>\nPage properties<properties/devenv-properties>\nDeveloping extensions<devenv-dev-overview>\nConfigure context-sensitive help<../help/context-sensitive-help>"}