{"title":"Profile extension object","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-profile-ext-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-profile-ext-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-profile-ext-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 profile extension object, which allows you to modify an individual experience for each user profile.","date":"2024-09-30","meta":{"topic":"article"},"outline":[{"level":1,"title":"Profile extension object","slug":"profile-extension-object","at":0,"chars":2539},{"level":2,"title":"Snippet support","slug":"snippet-support","at":1060,"chars":426},{"level":2,"title":"Profile extension example","slug":"profile-extension-example","at":1486,"chars":857},{"level":2,"title":"Related information","slug":"related-information","at":2343,"chars":196}],"text":"# Profile extension object\n> APPLIES TO: Business Central 2024 release wave 2 and later.\nThe profile extension object in Business Central allows you to customize existing user profiles. The profile extension object allows you to override properties from the target profile such as the role center page or the profile caption, and allows you to define additional devenv-page-customization-object to apply to the profile.\n> NOTE\n> Page customizations only apply to the Role Center they're specified for. In order to see them, in Business Central under My Settings, Role Center change to the specific Role Center that a page customization is defined for.\n> NOTE\n> Extension objects can have a name with a maximum length of 30 characters.\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 through Use Designer. See Resource exposure policy setting<devenv-security-settings-and-ip-protection>.\n## Snippet support\nTyping the shortcut tprofileextension creates the basic layout for a profile extension 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## Profile extension example\nThe following profile extension object example extends the `Business Manager` profile by replacing its description and its role center page. It also adds the customization MyCustomization to the list of customizations applied for the `Business Manager` profile. The customization modifies the layout of the `Customer List` to make the Name field invisible using the modify method. See properties/devenv-profile-properties.\n```al\nprofileextension MyProfileExt extends \"Business Manager\"\n{\n    ProfileDescription = 'A detailed description of who is this profile for, why/how to use it (etc)';\n    RoleCenter = MyNewRoleCenter;\n    Customizations = MyCustomization;\n}\n\npagecustomization MyCustomization customizes \"Customer List\"\n{\n    layout\n    {\n        modify(Name)\n        {\n            Visible = false;\n        }\n    }\n}\n```\n## Related information\nAL development environment<devenv-reference-overview>\nDeveloping extensions<devenv-dev-overview>\ndevenv-pages-overview\ndevenv-profile-object\ndevenv-page-customization-object"}