Manage tenant groups in Enterprise Hub

  • Updated on Apr 25, 2026
  • Published on Feb 16, 2026
  • 2 minute(s) read
Prev Next

Overview

Use the Tenant Groups feature in Enterprise Hub to organize tenants into logical groups, such as by region, industry, or function for streamlined control. This feature saves time, enhances security, and reduces errors when making changes that apply to many accounts at once.

Who uses this feature

  • Administrators

  • Applies to all business types

Feature configuration

  • This feature is currently in Early Access and available for specific accounts. It is subject to change. If you want to enable this feature for your account, join the waitlist here.

Things to know

  • When you add a tenant to a group, all users in that group gain access. Removing a tenant from the group removes access for all users.

  • You can create as many tenant groups as needed.

  • Tenants can belong to multiple groups.

  • Changes made to a tenant group apply to all users assigned to that group.

  • Only users with the proper permissions can create or edit tenant groups.

  • You cannot unassign a tenant from a user if that tenant is part of a group the user is assigned to. The tenant will appear grayed out.

Grant access to Tenant Groups

To grant access to Tenant Groups for a role:

  1. In Enterprise Hub, click User Management.
    User Management module for managing permissions and access in the Enterprise Hub.

  2. Select Roles.

  3. Either create a new user role or edit an existing user role.

  4. In the Enterprise Hub permissions tab, enable the Manage Tenant Groups permission for Settings.
    Settings permissions for managing tenant groups and removing tenants in Enterprise Hub.

  5. Click Save Changes. Users assigned this role can now see the Tenant Groups feature in Enterprise Hub.

Create a new tenant group

  1. Go to the Settings module.

  2. Click Tenant Groups.

  3. Click +Create New Group.
    User interface showing tenant groups with an option to create a new group.

  4. In the window that opens, enter a name and description for the group.

  5. When finished, click Next Step.
    Form for creating a new tenant group with name and description fields.

  6. Click Add Tenants to include them in the group.
    Interface for adding tenants to a group with a prompt to select tenants.

  7. Add tenants to the group. You can only see the tenants that are assigned to you.

  8. Add users to the group. You can do this now or later.

  9. When finished, click Done. When assigned, users automatically gain access to all tenants in that group.
    Interface for adding or removing tenants with selected options and a done button.

  10. Click Next Step to move the next tab.

  11. Click Add/Remove Users to assign the tenant group to users.
    User assignment interface for creating a new tenant group with search functionality.

  12. Select users from the list.

  13. When finished, click Done.
    User management interface showing selected users and a 'Done' button for confirmation.

  14. Click Finish to create a new tenant group.

Edit tenant groups

  1. Click the group.

  2. Add or remove tenants on the Tenants tab.

  3. Click Save Changes.

  4. On the Assigned Users tab, click the user.
    User management interface showing tenants and assigned users in the East Coast Region.You’re redirected to the Users screen.

Manage tenant groups in the Users section

  1. Go to User Management.

  2. Select a user.

  3. Go to the Tenants and Groups tab.

  4. View tenants assigned by:

    1. Tenant Groups: The groups a tenant is a part of.

    2. Individual tenants: Tenants that are not part of any group.
      Overview of tenant groups and individual tenants with assigned roles in a management system.

      Note: Make sure the user has access only to the group they are assigned to. Tenants assigned by groups must be removed by unassigning the tenant from the group, or removing the user from the group.


Invite a new tenant with tenant groups

  1. Go to the Settings module.

  2. Click Invites.

  3. Click +Invite Tenant.

  4. Enter the invite code and click Check Code. For more, see Manage tenant invites.

  5. Decide if you want to assign the tenant to any of the existing groups.
    User selection interface for inviting users to a network tenant.

    Tip: We recommend having a group ready before adding new tenants to streamline access.

All users in the assigned group automatically gain access to the tenant, which is why some appear in a read-only state. While you can assign individual users to a tenant, adding tenants to groups is faster and more efficient.

Related articles