{"title":"AccessByPermission Property","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/properties/devenv-accessbypermission-property/","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/properties/devenv-accessbypermission-property, 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/properties/devenv-accessbypermission-property","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":"Sets a value for a table field or UI element that determines the permission mask for an object that a user must have to see and access the related page fields or UI element in the client.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Applies to","slug":"applies-to","at":657,"chars":660},{"level":2,"title":"Property Values","slug":"property-values","at":1317,"chars":495},{"level":2,"title":"Syntax","slug":"syntax","at":1812,"chars":64},{"level":2,"title":"Remarks","slug":"remarks","at":1876,"chars":606},{"level":2,"title":"Dependent Property","slug":"dependent-property","at":2482,"chars":334},{"level":2,"title":"Related information","slug":"related-information","at":2816,"chars":111}],"text":"> Version: _Available or changed with runtime version 1.0._\nSets a value for a table field or UI element that determines the permission mask for an object that a user must have to see and access the related page fields or UI element in the client. The UI element will be removed at runtime if the user does not have permissions to a certain object as specified in the AccessByPermission property.\nAll types of UI elements will be removed if they relate to an object to which the user does not have the required permissions:\n Fields on pages, including FactBoxes\n Actions on pages, including ToolBars and navigation panes\n Page parts, such as Lines FastTabs\n## Applies to\n Table field\n Page Field\n Page Part\n Page System Part\n Page Chart Part\n Page Action\n Page Custom Action\n Page File Upload Action\n Page\n Report\n> IMPORTANT\n> If the AccessByPermission property is applied to a page field from a virtual table, this property is ignored. This means that users will see this field on the page in the client even if they do not have the permissions that are required by this property.\n> NOTE\n> For this property to take effect in the client, the UI Elements Removal setting of Business Central Server configuration must be set to LicenseFile or LicenseFileAndUserPermissions. See ../../administration/hide-ui-elements.\n## Property Values\nThe AccessByPermission property values are as described below:\nValues|Represents|Description\nR|Read|Specify if Read permission is required to display the UI element.\nI|Insert|Specify if Insert permission is required to display the UI element.\nM|Modify|Specify if Modify permission is required to display the UI element.\nD|Delete|Specify if Delete permission is required to display the UI element.\nX|Execute|Specify if Execute permission is required to display the UI element.\n## Syntax\n```al\nAccessByPermission = tabledata MySetup = I;\n```\n## Remarks\nThe property value for TableData can be set with a combination of Read, Insert, Modify and Delete permissions. This means, you can set the property value to ``RIMD`` permissions; the value ``X`` is not valid for TableData.\nFor other objects including Table, Page, Query, Report, Codeunit, or Xmlport, it can only be Execute permission. This means, you can set the property value to ``X`` for the specified object type.\n> NOTE\n> If you set multiple permissions, then one or the other applies. If specifying ``RIMD`` permissions, the user needs to have at least one of the R, I, M, D permissions.\n## Dependent Property\nThe UsageCategory property is a required setting used together with the AccessByPermission property. This enables a page or a report to be available in Search for the navigation support. For more information about navigation support, see Adding Pages and Reports to Search<../devenv-al-menusuite-functionality>.\n## Related information\nGet Started with AL<../devenv-get-started>\nDeveloping Extensions<../devenv-dev-overview>"}