> ## Documentation Index
> Fetch the complete documentation index at: https://docs.idemeum.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Multi-tenant portal overview

> Create tenants to manage multiple organizations / customers from one portal.

## How multi-tenant portal works

Idemeum is designed based on multi-tenant architecture, and it allows you to create multiple tenants / organizations. As an IT team, you can create separate tenants for various organizations, apply access controls, enable different products per organization, and more. As an MSP you can create separate tenants for each customer you manage. There are two types of tenants in idemeum:

<AccordionGroup>
  <Accordion title="Parent tenant" defaultOpen icon="border-top">
    This is your main tenant residing on your primary domain - `<company-name>.idemeum.com`**\_. \_**Parent tenant is used to create child tenant and manage global settings that apply to all organizations.
  </Accordion>

  <Accordion title="Child tenant" defaultOpen icon="border-bottom">
    This is a tenant you create for each customer / organization that you manage, and it is accessible at `org1-<company-name>.idemeum.com`, `org2-<company-name>.idemeum.com`, etc. When you install desktop agents, they are associated with child tenants.
  </Accordion>
</AccordionGroup>

## Create child tenant

* Navigate to the admin portal of your parent idemeum tenant
* Access `Tenants` on the left
* Click `Add tenant` and then choose `Add manually`
* Specify the organization `name` (will go into the URL) and the `display name` (friendly description)

<Info>
  Say my parent tenant is `company.idemeum.com`. If `name` → `bank` and `display name` → `banking organization`, then the child tenant → `bank-company.idemeum.com`***.***
</Info>

* Save the configuration

<img src="https://mintcdn.com/idemeum/GAybC25ty5B2g8wf/images/q1.png?fit=max&auto=format&n=GAybC25ty5B2g8wf&q=85&s=d05d00db5b85ca52dc33f336228fcf33" alt="Q1" width="1600" height="1134" data-path="images/q1.png" />

## Access child tenant

<AccordionGroup>
  <Accordion title="Tenant switcher" defaultOpen icon="light-switch">
    At the top left side of the screen you can leverage the tenant dropdown to navigate between various organizations.

    <img src="https://mintcdn.com/idemeum/GAybC25ty5B2g8wf/images/w1.png?fit=max&auto=format&n=GAybC25ty5B2g8wf&q=85&s=c880defdf2f7b3d071c02338a7860dc5" alt="W1" width="1600" height="1134" data-path="images/w1.png" />
  </Accordion>

  <Accordion title="Parent tenant app portal" defaultOpen icon="circle-stop">
    When you switch to the app portal of your parent tenant, you will be presented with all organizations.

    <img src="https://mintcdn.com/idemeum/Va1CYIJc-ctoENb6/images/w2.png?fit=max&auto=format&n=Va1CYIJc-ctoENb6&q=85&s=f3e929040d25c1513d61faef79e600c4" alt="W2" width="1600" height="1134" data-path="images/w2.png" />
  </Accordion>

  <Accordion title="Tenants table" defaultOpen icon="table">
    If you access the admin portal of your parent, then navigate to `Tenants` section, you will then be able to click on the link for any customer / organization that you created.

    <img src="https://mintcdn.com/idemeum/GAybC25ty5B2g8wf/images/w3.png?fit=max&auto=format&n=GAybC25ty5B2g8wf&q=85&s=d71b11e3284af57afad93fdcdfaae1eb" alt="W3" width="1600" height="1134" data-path="images/w3.png" />
  </Accordion>
</AccordionGroup>

## **Delete child tenant**

* Access your parent tenant admin portal
* Navigate to `Tenants` section
* Search for the organization you want to delete, click on `...` and then choose `Delete`