--- title: Managing user groups description: Adding individual users to PingCentral applications can be a time-consuming process. If you have user groups defined in your data store, you can add the groups to PingCentral so that application owners can associate them with PingCentral applications and provide application access to multiple users at once. component: pingcentral version: 2.2 page_id: pingcentral:pingcentral_for_iam_administrators:pingcentral_managing_groups canonical_url: https://docs.pingidentity.com/pingcentral/2.2/pingcentral_for_iam_administrators/pingcentral_managing_groups.html revdate: August 3, 2023 section_ids: adding-user-groups: Adding user groups steps: Steps result: Result: result-2: Result: updating-user-groups: Updating user groups steps-2: Steps result-3: Result: deleting-user-groups: Deleting user groups steps-3: Steps result-4: Result: --- # Managing user groups Adding individual users to PingCentral applications can be a time-consuming process. If you have user groups defined in your data store, you can add the groups to PingCentral so that application owners can associate them with PingCentral applications and provide application access to multiple users at once. Start by signing on PingCentral using single sign-on (SSO). Next, add information about each group, such as the group name, display name, and description to PingCentral. Group names should match the group names in your data store and aren't case sensitive. If you have a large number of groups to add, you can upload the information into PingCentral in a `.csv` file. Then, you can add these groups of users to PingCentral applications, which provides application access to each user in the group. Identities, user groups, and group membership information are managed in your data store. When a user signs on to PingCentral, the groups to which the user belongs are sent as part of the groups claim. PingCentral not only updates its existing group information with information from the data store, but if the claim contains new groups, it adds those groups to PingCentral, as shown in this diagram. It also updates the user profile to reflect current group memberships. ![This flowchart illustrates the way group information is updated when users sign on to .](_images/xhf1616786720509.png) ## Adding user groups After adding groups to PingCentral, associate them with PingCentral applications and provide application access to many users at once. Add groups one by one or import group information in a `.csv` file. ### Steps 1. Sign on to PingCentral using SSO. | | | | - | --------------------------------------------------------------- | | | Group functionality is only available if you sign on using SSO. | 2. To add groups of users one by one: 1. On the **Groups** tab, click **Add Group**. 2. On the **Add Group** page, complete these fields: * **Group Name**: Enter the group name. Group names should match the group names in your data store and are not case sensitive. * **Display Name (Optional)**: Enter the name to display in PingCentral. * **Description (Optional)**: Enter a description of the user group to display in PingCentral. 3. Click **Save and Close**. #### Result: The new group displays at the top of the **Groups** list. Click the **Expand** icon to see information about the groups and its members. Use the filter to locate specific groups. ![A screen capture showing the Groups page with the new group displayed at the top of the page.](_images/hrh1617036254344.png) 3. To import information about a group of users: 1. On the **Groups** tab, click **Import Groups**. 2. On the **Upload File** page, click **Choose**. 3. Select the `.csv` files that you want to import and click **Open** and click **Next**. 4. On the **Preview Groups** page, review the group names, display names, and descriptions, and ensure they are accurate. If not, correct the `.csv` file and import it again. The **Name** field is required, but the **Display Name** and **Description** fields are optional. ![A screen capture showing the Preview Groups page and the information uploaded in the CSV file.](_images/jms1617039185073.png) 5. Click **Save and Close**. #### Result: The new group displays at the top of the **Groups** list. Click the **Expand** icon to see information about the groups and its members. Use the filter to locate specific members or groups. After application owners associate users or groups of users with their applications, the ownership information also displays when you select the application. ![A screen capture showing the Applications page and the owners assigned to the new application.](_images/fhs1617035391927.png) ## Updating user groups You can update the name, display name, and description for a user group. ### Steps 1. To update user group information, click the **Expand** icon associated with the group that you want to update and then click the **Pencil** icon. #### Result: All of the editable information displays on the page. 2. Update the information in the **Name**, **Display Name**, and **Description** fields as needed, and click **Save and Close**. | | | | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | If the group name is updated in PingCentral but not in your data store, the groups will be out of sync, which might cause users to lose access to their applications. | ## Deleting user groups Delete user groups when they are no longer needed. ### Steps 1. On the **Groups** tab, select the group you want to delete and click the associated **Delete** icon. #### Result: A message displays asking you if you want to delete the group. 2. Click **Delete**.