{"title":"Manage permissions through user groups (legacy)","url":"https://jonas-paprotka.de/docs/ui-legacy-user-groups/","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/ui-legacy-user-groups, MicrosoftDocs/dynamics365smb-docs at 46907ac (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/ui-legacy-user-groups","source":{"name":"Business Central application docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-docs","commit":"46907ace177f8d31deba47a2fdb57c3336e66252","date":"2026-11-19"},"checked":"2026-11-19","description":"Manage legacy user groups and permission sets in Business Central version 24 and earlier, and understand the transition to security groups.","date":"2026-11-12","meta":{"topic":"how-to"},"outline":[{"level":1,"title":"Manage permissions through user groups (legacy)","slug":"manage-permissions-through-user-groups-legacy","at":0,"chars":7442},{"level":2,"title":"Add users to a user group","slug":"add-users-to-a-user-group","at":1592,"chars":461},{"level":2,"title":"Copy a user group and all its permission sets","slug":"copy-a-user-group-and-all-its-permission-sets","at":2053,"chars":1153},{"level":2,"title":"Assign permission sets to user groups","slug":"assign-permission-sets-to-user-groups","at":3206,"chars":481},{"level":2,"title":"Assign a permission set on the Permission Set by User Group page","slug":"assign-a-permission-set-on-the-permission-set-by-user-group-page","at":3687,"chars":696},{"level":2,"title":"Convert user groups to security groups","slug":"convert-user-groups-to-security-groups","at":4383,"chars":2488},{"level":3,"title":"Convert user groups to permission sets","slug":"convert-user-groups-to-permission-sets","at":5205,"chars":1149},{"level":3,"title":"License configurations still apply","slug":"license-configurations-still-apply","at":6354,"chars":517},{"level":2,"title":"Related information","slug":"related-information","at":6871,"chars":571}],"text":"# Manage permissions through user groups (legacy)\n> NOTE\n> Security groups replace user groups starting in 2023 release wave 1 (version 22). User groups aren't available after 2024 release wave 1 (version 24).\n> Security groups work like user groups, but they're defined in Microsoft Entra ID for online or Windows Active Directory for or on-premises instead of Business Central. This setup lets admins reuse security groups with other Dynamics 365 apps. See Control Access to Business Central Using Security Groups<ui-security-groups>.\n> With Business Central on-premises version 22, 23, or 24, use the assisted setup guide to convert user groups to permission sets. This process helps you transition to security groups. See Control Access to Business Central Using Security Groups<#convert-user-groups-to-permission-sets>.\nUser groups help you manage permission sets across the company. Business Central online includes default user groups that are assigned to users automatically based on their license. You can add users manually to a user group, and you can create new user groups as copies of existing ones.\nYou start by creating a user group. Then you assign permission sets to the group to define which object users of the group can access. When you add user to the group, the permission sets defined for the group applies to the user.\nPermission sets assigned to a user through a user group stay synchronized. A change to the user group permissions is automatically propagated to the users. If you remove a user from a user group, the involved permissions are automatically revoked.\n## Add users to a user group\nThe following procedure explains how to add users to an existing user group. See #copy-a-user-group-and-all-its-permission-sets.\n1. Select Search (Alt+Q) in the upper-right corner, enter User Groups, and then choose the related link.\n 1. Alternatively, on the Users page, choose the User Groups action.\n2. On the User Group page, choose the User Group Members action.\n3. On the User Group Members page, choose the Add Users action.\n## Copy a user group and all its permission sets\nTo quickly define a new user group, you can copy all permission sets from an existing user group to your new user group.\n> NOTE\n> The user group members aren't copied to the new user group. You must add them manually. See #add-users-to-a-user-group.\n1. Select Search (Alt+Q) in the upper-right corner, enter User Groups, and then choose the related link.\n2. Select the user group that you want to copy, and then choose the Copy User Group action.\n3. In the New User Group Code field, enter a name for the group, and then choose the OK button.\nThe new user group is added to the User Groups page. Proceed to add users. See #add-users-to-a-user-group.\n> IMPORTANT\n> A validation error displays if you try to assign a user group that refers to a permission set which was defined in an extension that you uninstalled. It's because the App ID of the extension is validated whenever something references it. To assign that user group to a user, either:\n > Reinstall the extension.\n > Remove the reference of the uninstalled extension from the permission set.\n > Remove that permission set from the user group.\n## Assign permission sets to user groups\n1. Select Search (Alt+Q) in the upper-right corner, enter User Groups, and then choose the related link.\n2. Select the user group that you want to assign permission to.\n Any permission sets that are already assigned to the user are displayed in the Permission Sets FactBox.\n3. Choose the User Permission Sets action to open the User Permission Sets page.\n4. On the User Permission Sets page, on a new line, fill in the fields as necessary.\n## Assign a permission set on the Permission Set by User Group page\nThe following procedure explains how to assign permission sets to a user group on the Permission Set by User Group page.\n1. Select Search (Alt+Q) in the upper-right corner, enter Users, and then choose the related link.\n2. On the Users page, select the relevant user, and then choose the Permission Set by User Group action.\n3. On the Permission Set by User Group page, select the [user group name] field on a line for the relevant permission set to assign the set to the user group.\n4. Select the All User Groups checkbox to assign the permission set to all user groups.\nYou can also assign permission sets directly to a user.\n## Convert user groups to security groups\n> NOTE\n> Security groups replace user groups in 2024 release wave 2 (version 25) and later. If you're using on-premises version 22, 23, or 24, use the assisted setup guide to convert user groups to permission sets and transition to security groups.\nSecurity groups are very similar to the user groups described in this article. However, user groups are only relevant for Business Central. Security groups are based on groups in Microsoft Entra ID or Windows Active Directory, depending on whether you're using Business Central online or on-premises, respectively. Groups benefit administrators because they can use them with other Dynamics 365 apps. For example, if salespeople use Business Central and SharePoint, administrators don't have to recreate the group and its members.\n### Convert user groups to permission sets\nIn Business Central versions 22 through 24, you can convert user groups to permission sets in your tenant. The permission sets provide the same functionality as user groups. Microsoft removes user groups starting in version 25. Here are some examples:\n You can use the Users FactBox to manage permissions for users.\n Drill down on the permission set name to add other permission sets to the set you're working on. See ui-define-granular-permissions#to-add-other-permission-sets.\nUse the User Group Migration assisted setup guide to convert your groups. To start the guide, on the Feature Management page, find Feature: Convert user group permissions, and then choose All Users in the Enabled For field. The assisted setup guide offers the following options for the conversion.\nOption|Description\nAssign to user|Assign the permissions in user groups directly to the users who were assigned to the group, and remove their user group assignments.\nConvert to a permission set|Create a new permission for the permissions in each user group. The new permission set is assigned to all members of each user group.\n### License configurations still apply\nYou can configure permissions in Business Central based on licenses. Those permissions are directly assigned to new users. These configurations still apply, even if you start using security groups.\nTo use security groups exclusively, remove the license configurations. See Create users according to licenses<ui-how-users-permissions>.\nYou can remove license configurations on the License Configuration page. Choose a license, and then delete all permission sets assigned to it.\n## Related information\nCreate Users According to Licenses<ui-how-users-permissions>\nSet Up Business Central Access in Teams with Microsoft 365 Licenses<admin-access-with-m365-license-setup>\nLearn about groups and access rights in Microsoft Entra ID<https://learn.microsoft.com/entra/fundamentals/concept-learn-about-groups>\nActive Directory security groups<https://learn.microsoft.com/windows-server/identity/ad-ds/manage/understand-security-groups>\nFind free e-learning modules for Business Central here<https://learn.microsoft.com/training/dynamics365/business-central>"}