{"title":"Page customization object","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-page-customization-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-customization-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-customization-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":"The page customization object in Business Central allows you to add changes to the layout and actions on page that are accessible for a profile.","date":"2025-08-19","meta":{"topic":"how-to"},"outline":[{"level":2,"title":"Snippet support","slug":"snippet-support","at":1330,"chars":419},{"level":2,"title":"Views","slug":"views","at":1749,"chars":256},{"level":2,"title":"Page customization example","slug":"page-customization-example","at":2005,"chars":1013},{"level":2,"title":"Adding groups and page fields based on table fields","slug":"adding-groups-and-page-fields-based-on-table-fields","at":3018,"chars":1428},{"level":3,"title":"Editable fields in page customizations","slug":"editable-fields-in-page-customizations","at":3724,"chars":722},{"level":2,"title":"Related information","slug":"related-information","at":4446,"chars":337}],"text":"The page customization object in Business Central allows you to add changes to the layout and actions on page that are accessible for a profile. The page customization object has more restrictions than the page extension object<devenv-page-ext-object>; when you define a new page customization object, you can't add variables, procedures, or triggers. You can add actions, fields, and groups to the page customization object.\nLearn how to use specific keywords to change the page customization layout in devenv-page-ext-object#using-keywords-to-place-actions-and-controls.\n> NOTE\n> A single page customization can be used with multiple profiles within the same extension. Page customizations only apply to the RoleCenters they're specified for. In order to view or change the RoleCenters in the client, go to My Settings, and then choose Role Center.\n> NOTE\n> Extension objects can have a name with a maximum length of 30 characters.\n> NOTE\n> Modifying actions in Cue groups on page extensions isn't supported.\n> NOTE\n> The property allowDebugging, which is a setting under resourceExposurePolicy doesn't apply to page customizations. Page customizations defined in an extension with allowDebugging set to false can still be copied using Designer. See Resource exposure policy setting<devenv-security-settings-and-ip-protection>.\n## Snippet support\nTyping the shortcut tpagecust creates the basic layout for a page customization 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## 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 customization example\nThe following page customization example MyCustomization makes changes to Customer List. By using the moveafter method, `Blanket Orders` is moved after the Orders action item. And the modify method is used to hide the NewSalesBlanketOrder action item.\n```al\nprofile TheBoss\n{\n    Description = 'The Boss';\n    RoleCenter = \"Business Manager Role Center\";\n    Customizations = MyCustomization;\n    Caption = 'Boss';\n}\n\npagecustomization MyCustomization customizes \"Customer List\"\n{\n    actions\n    {\n        moveafter(Orders; \"Blanket Orders\")\n\n        modify(NewSalesBlanketOrder)\n        {\n            Visible = false;\n        }\n\n    }\n}\n```\nYou can use the same page customization on another profile within the same extension package by referencing its name from the profile definition, for example:\n```al\nprofile TheSalesman\n{\n    ProfileDescription = 'The Boss';\n    RoleCenter = \"Sales Manager Role Center\";\n    Customizations = MyCustomization;\n    Caption = 'Salesman';\n}\n```\n## Adding groups and page fields based on table fields\n> APPLIES TO: Business Central 2023 release wave 2 (version 23) and later\nYou can add groups and page fields using a table field as source expression in page customizations as illustrated in the following example.\n```al\npagecustomization MyPageCust customizes MyPage\n{\n    layout\n    {\n        addfirst(Content)\n        {\n            field(MyPageCustField; Rec.MyTableField) {...}\n        }\n    }\n}\n```\nTo specify if a table field can be used as a source expression for page fields that are created in page customizations, use the properties/devenv-allowincustomizations-property. The default behavior is that a table field can be used in such a way.\n### Editable fields in page customizations\n> APPLIES TO: Business Central 2025 release wave 2 and later\nWith runtime 16, you can make page fields defined in page customizations editable. In versions prior to runtime 16, page fields were read-only, unlike fields that are declared in pages or page extensions.\nThe following example shows how to make a page field editable in a page customization.\n```al\npagecustomization MyPageCust customizes MyPage\n{\n    layout\n    {\n        addfirst(Content)\n        {\n            field(MyPageCustField; Rec.MyTableField) { Editable = true; }\n        }\n    }\n}\n```\nTo control how table fields are used in customizations, you can use the properties/devenv-allowincustomizations-property.\n## Related information\nDeveloping extensions<devenv-dev-overview>\nAL development environment<devenv-reference-overview>\ndevenv-page-object\nPage extension object<devenv-page-ext-object>\ndevenv-views\nPage, page fields, and page extension properties<properties/devenv-page-property-overview>\nproperties/devenv-allowincustomizations-property"}