{"title":"Permission set extension object","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/devenv-permissionset-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-permissionset-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-permissionset-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 permission set extension object in AL for Business Central.","date":"2025-06-02","meta":{"topic":"concept-article"},"outline":[{"level":1,"title":"Permission set extension object","slug":"permission-set-extension-object","at":0,"chars":2844},{"level":2,"title":"Designing with cautiousness","slug":"designing-with-cautiousness","at":840,"chars":831},{"level":2,"title":"Snippet support","slug":"snippet-support","at":1671,"chars":439},{"level":2,"title":"Permission set example","slug":"permission-set-example","at":2110,"chars":358},{"level":2,"title":"Related information","slug":"related-information","at":2468,"chars":376}],"text":"# Permission set extension object\n> APPLIES TO: Business Central 2021 release wave 1 (v18.0) and later\nThe permission set extension object in Business Central adds permissions to an existing permission set defined in AL. A permission set extension object can't remove permissions from an existing permission set; it can only add permissions. If you, for example, add an extension to Business Central, you can use permission set extension objects to grant permissions to the objects in your extension. This means that the admin of Business Central doesn't have to assign extra permission sets to the users, because that automatically happens when the extension is installed, and the permissions go away if the extension is uninstalled.\nLearn more about which permissions can be assigned to objects in devenv-permissions-on-database-objects.\n## Designing with cautiousness\nIf a permission set is extended through AL, that extension makes additive changes to the permission set. This means that an extension can provide elevated privileges to an otherwise limited set of permissions. Building permission sets that can be extended must be done carefully with this in mind.\nA best practice when creating an application with permission set extensions is to ensure that they only add permissions for objects, which are part of the application. This is because an administrator might not realize, or expect, that installing a new application might also grant elevated privileges. This design pattern minimizes the possibility of the permission set extension impacting any functionality beyond the intended application. This keeps the permission changes predictable and targeted.\n## Snippet support\nTyping the shortcut tpermissionsetextension creates the basic layout for a permission set 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## Permission set example\nThe following permission set extension example extends the `Sales Person` devenv-permissionset-object#permission-set-example by adding direct insert and delete permissions to the Currency table data.\n```al\npermissionsetextension 50140 \"Extended Sales Doc\" extends \"Sales Person\"\n{​\n    Permissions =​ tabledata Currency = ID;\n}\n```\n## Related information\nDeveloping extensions<devenv-dev-overview>\nAL development environment<devenv-reference-overview>\nEntitlements and permission set overview<devenv-entitlements-and-permissionsets-overview>\nPermission set object<devenv-permissionset-object>\ndevenv-permissions-on-database-objects\nproperties/devenv-assignable-property\nproperties/devenv-permissions-property"}