{"title":"Designing profiles","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-design-profiles/","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-design-profiles, 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-design-profiles","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":"Learn how to use AL profiles, profile extensions, and page customizations to tailor Business Central pages to user roles and translate profile text.","date":"2026-11-05","meta":{"topic":"concept-article"},"outline":[{"level":2,"title":"Profile objects","slug":"profile-objects","at":477,"chars":248},{"level":2,"title":"Profile extension objects","slug":"profile-extension-objects","at":725,"chars":253},{"level":2,"title":"Page customization object","slug":"page-customization-object","at":978,"chars":648},{"level":2,"title":"Profile and page customization example","slug":"profile-and-page-customization-example","at":1626,"chars":907},{"level":2,"title":"Using the client to create AL profiles, profile extensions, and page customizations","slug":"using-the-client-to-create-al-profiles-profile-extensions-and-page-customizations","at":2533,"chars":359},{"level":2,"title":"Translating profiles","slug":"translating-profiles","at":2892,"chars":1714},{"level":2,"title":"Related information","slug":"related-information","at":4606,"chars":252}],"text":"A profile makes a role center page and its associated pages and reports available to users in the client. Use profiles to tailor Business Central pages to the daily tasks of a role in the company. In the client, profiles are referred to as roles. Users can switch their Role on the My Settings page.\nCreating profiles in AL involves three different object types: devenv-profile-object, profile extension object<devenv-profile-ext-object>, and devenv-page-customization-object.\n## Profile objects\nA profile object specifies an ID for the profile, a display name that appears in the client, a role center page, and the page customization objects that apply to the profile. Different profiles can use the same role center page.\n## Profile extension objects\nA profile extension object overrides properties of a profile object defined in another AL extension, such as its caption or role center page. It can also define additional page customization objects to apply to the profile.\n## Page customization object\nA page customization object specifies layout and action modifications to a specific page object. For example, you can move actions, fields, columns on a list, or entire parts. The modifications apply to all users of the profiles that use the customization.\nTo make the modifications, you use devenv-page-ext-object#using-keywords-to-place-actions-and-controls in the layout and actions sections.\nThe same page customization objects can be used in different profile objects. A profile object doesn't have to use page customization objects, but a page customization has no effect without being associated with a profile.\n## Profile and page customization example\nThe following example creates a profile object that uses the `\"Business Manager Role Center\"` page. It uses two page customization objects. One hides the Customers action on the role center. The other moves the Balance (LCY) column after Phone No. on the Customer List page.\n```al\nusing Microsoft.Finance.RoleCenters;\nusing Microsoft.Sales.Customer;\n\nprofile TheBoss\n{\n    ProfileDescription = 'The Boss';\n    RoleCenter = \"Business Manager Role Center\";\n    Customizations = BusinessManagerCust, CustomerListCust;\n    Caption = 'Boss';\n}\n\npagecustomization BusinessManagerCust customizes \"Business Manager Role Center\"\n{\n    actions\n    {\n        modify(Customers)\n        {\n            Visible = false;\n        }\n    }\n}\n\npagecustomization CustomerListCust customizes \"Customer List\"\n{\n    layout\n    {\n        moveafter(\"Phone No.\"; \"Balance (LCY)\")\n    }\n}\n```\n## Using the client to create AL profiles, profile extensions, and page customizations\nAdministrators and consultants can create profiles or fine-tune page customizations in the client. As a developer, you can export these changes for use in AL extensions. See Using the client to create profiles and page customizations<devenv-design-profiles-using-client>.\n## Translating profiles\nA profile's Caption and ProfileDescription properties appear in the client user interface. To translate them, generate an XLIFF file and add a translation for each target language. The generated file contains a `<source>` element for each property. Add a `<target>` element with the translated text. See devenv-work-with-translation-files.\nThe following XLIFF example translates the profile from en-US to da-DK. Keep the translation-unit IDs from the file generated for your extension.\n```xml\n<xliff version=\"1.2\" xmlns=\"urn:oasis:names:tc:xliff:document:1.2\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" xsi:schemaLocation=\"urn:oasis:names:tc:xliff:document:1.2 xliff-core-1.2-transitional.xsd\">\n  <file datatype=\"xml\" source-language=\"en-US\" target-language=\"da-DK\" original=\"profiles\">\n    <body>\n      <group id=\"body\">\n        <trans-unit id=\"Profile 3523819904 - Property 4111922599\" size-unit=\"char\" translate=\"yes\" xml:space=\"preserve\">\n          <source>The Boss</source>\n          <target>Chefen</target>\n          <note from=\"Developer\" annotates=\"general\" priority=\"2\"></note>\n          <note from=\"Xliff Generator\" annotates=\"general\" priority=\"3\">Profile TheBoss - Property ProfileDescription</note>\n        </trans-unit>\n        <trans-unit id=\"Profile 3523819904 - Property 2879900210\" size-unit=\"char\" translate=\"yes\" xml:space=\"preserve\">\n          <source>Boss</source>\n          <target>Chef</target>\n          <note from=\"Developer\" annotates=\"general\" priority=\"2\"></note>\n          <note from=\"Xliff Generator\" annotates=\"general\" priority=\"3\">Profile TheBoss - Property Caption</note>\n        </trans-unit>\n      </group>\n    </body>\n  </file>\n</xliff>\n```\n## Related information\nDeveloping extensions<devenv-dev-overview>\nAL development environment<devenv-reference-overview>\ndevenv-page-object\nPage extension object<devenv-page-ext-object>\nPage extension properties<properties/devenv-page-property-overview>"}