Groups

Groups

This article explains how to use groups to manage user visibility and permissions efficiently.

Overview

Groups allow you to organize users and control their visibility over customers and other users. Each group defines which customers and users its members can see within the platform.

The Groups page shows all configured groups with their match labels, customer count, and user count. From here you can:

  1. Navigate to Organization Admin in the sidebar.
  2. Expand the Groups section to see group types (Viewers, Analysts).
  3. Click Add viewer group or Add analyst group to create a new group.
  4. Enter a name for the group.
  5. Add a description to help identify the group's purpose.
  6. Associate the customers that group members can view.
  7. Associate the users that group members can view.
  8. Click Save to create the group.
Groups

Managing Groups

Editing a Group

To modify an existing group:

  1. Navigate to Organization Admin > Groups > Viewers or Analysts.
  2. Find the group you want to modify.
  3. Click the edit icon next to the group.
  4. Update the group name, description, or associations:
    • Name: Change the group's display name.
    • Description: Update the group's purpose description.
    • Customers: Modify which customers are visible to group members.
    • Users: Modify which users are visible to group members.
  5. Click Save to apply the changes.

Deleting a Group

To delete a group:

  1. Navigate to Organization Admin > Groups > Viewers or Analysts.
  2. Find the group you want to delete.
  3. Click the delete icon next to the group.
  4. Confirm the deletion.

Match Labels (Advanced)

Groups support match labels for advanced configuration. Match labels allow you to automatically associate resources with groups based on metadata labels, enabling dynamic group membership without manual configuration.

Best Practices

  • Use Descriptive Names: Name groups clearly to indicate their purpose.
  • Document Group Purposes: Add descriptions to help administrators understand each group's role.
  • Regular Reviews: Periodically review group memberships to ensure appropriate access.
  • Principle of Least Privilege: Configure groups with the minimum visibility needed for the job function.