Skip to main content

Knowledge Base

Multitenancy

Last Modified: Jul 29, 2026

How to set up your multitenancy organization

Parent companies should create the invitation and share it with the child companies. 

Once the information is added by the child company, the parent company can review the request and establish the relation.

Step 1: Create an invitation (parent company)

  1. Click on Create invitation (via Admin settings as shown below).

2. Choose the code type; one-time use or reusable.

3. Set the Expiration time.

4. Optional: You can select up to 10 users to associate as tenant managers. You can also add them after the relation is established.

5. Share the invitation code and any of your company administrator email with the child company via their preferred method.

Step 2: Join the organization (child company) by creating a relation request

1. Go to the Relation requests tab (via Admin settings as shown below).

2. Click on Join.

3. Enter the Invitation Code provided and any parent company administrator's address:

Multitenancy Create Relation Request

4. Check the acknowledgment box.

Multitenancy Create Relation Request 2

5. (If tenant managers were assigned) Set their roles.

Multitenancy Create Relation Request 3

6. Optional: If you have more than one license feature, you need to choose which one you would like to assign to these users:

Step 3: Review and approve the request (parent company)

  1. Go to the Invitations tab.
  2. Select the request and click Review request.
  3. Review assigned permissions.
  4. Click Approve or Reject.
Review Request

How to manage your multitenancy organization

Revoke a pending invitation (parent)

This is only possible if the invitation code is still active. Once revoked, the invitation code becomes invalid and cannot be used again.

Revoke a pending relation request (child)

If the child company decides not to proceed, it can revoke the request. A pending request can be revoked, canceling the request to join the parent organization. Once the relationship is established, the company can terminate it in the Hierarchy tab.

Terminate a relation (parent or child)

Either the parent or child company can terminate an existing multitenancy relation at any time. Once the relation is terminated, the companies are no longer connected, and all tenant manager access granted through the relation is removed from the child company. If the companies want to reconnect in the future, they must create a new invitation and complete the multitenancy setup process again.
 

To terminate a multitenancy relation, follow these steps:

  1. Go to the Hierarchy tab.
  2. Select the company.
  3. Click Terminate relation.
  4. Confirm by clicking Terminate.
Terminate Relation

Note: To re-establish a terminated relation, repeat the full setup process.

Request to add tenant managers (parent)

  1. Go to the Hierarchy tab.
  2. Select the child company.
  3. Click Add tenant managers.
  4. Choose users (only those not already added or pending) and click Add tenant manager.
  5. The child company will review the request in Pending requests.
Add Tenant Manager

Approve or decline tenant manager requests (child)

  1. Go to Pending requests under User management.
  2. Click Accept or Decline for each request.
Multitenancy Accept Deny Requests

Note: Bulk actions are not supported.

Remove tenant manager access

For Parent Company:
  1. Go to Company users.
  2. See user details.
  3. Remove access under Multitenancy. 

 

Multitenancy Remove Access

 

For Child Company:
  1. Go to External users.
  2. Select one or more Tenant Managers.
  3. Click on Remove from company.
  4. Confirm by selecting the checkbox and clicking on Remove. 

Note: You can remove access for multiple Tenant Managers at the same time. 

Multitenancy Remove External Users

Use the tenant switcher

Tenant managers can switch between companies they have access to using the Tenant switcher. This includes their own company and any connected ones.

Multitenancy Switch Tenant