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

# How to migrate users in bulk in Tenant Admin Portal

> This document provides step-by-step instructions to migrate users in bulk from one connection to another in Tenant Admin Portal.

**Pre-requisite:**

* You must be a Tenant Admin in Tenant Admin Portal.

> [!NOTE]
>
> **Note:**
>
> * Supervisors and Admins cannot be migrated to another connection.
> * Users with a facial credential uploaded in the portal cannot be migrated. The Admin must remove the user's facial credential before proceeding with migration.
> * Always consult Oloid Support before initiating the migration process to ensure all pre-requisites are met.

**Steps to migrate user:**

1. Log in to the **Tenant Admin Portal**.
2. On the homepage, select **Directory** from the left menu panel.

   ![How to migrate users in bulk in Tenant... - screenshot 1](https://mintcdn.com/oloid-999c42b2/GCwkwFtUXAup1WQ7/images/intercom/10435072/image-3f33de5b.png?fit=max\&auto=format\&n=GCwkwFtUXAup1WQ7\&q=85\&s=b1b62c00207c02c2b7c9ecad103b2ea6)

   The **Users** page is displayed.
3. Select **Migrate Users** from the left menu panel.

   ![How to migrate users in bulk in Tenant... - screenshot 2](https://mintcdn.com/oloid-999c42b2/GCwkwFtUXAup1WQ7/images/intercom/10435072/image-ffdd1ff6.png?fit=max\&auto=format\&n=GCwkwFtUXAup1WQ7\&q=85\&s=2869bbec71d97662ae3bf164519d760a)

   The **Migrate Users** page is displayed.
4. Click **Migrate Users** from the top right.

   ![How to migrate users in bulk in Tenant... - screenshot 3](https://mintcdn.com/oloid-999c42b2/GCwkwFtUXAup1WQ7/images/intercom/10435072/a5c4bce4-be62-45ce-b6a0-60e00dc1ec95-651aa080.png?fit=max\&auto=format\&n=GCwkwFtUXAup1WQ7\&q=85\&s=fa7f5587bde533de4c6795b9a5cfac3c)

   The **Migrate Users** pop-up is displayed
5. Do the following:
   1. Click **Download Template**.
      You may download a **.csv** or **.json** file as per your requirement.

      ![How to migrate users in bulk in Tenant... - screenshot 4](https://mintcdn.com/oloid-999c42b2/GCwkwFtUXAup1WQ7/images/intercom/10435072/0720637e-f17e-4821-9a17-da4f75bedc96-f52a9fd9.png?fit=max\&auto=format\&n=GCwkwFtUXAup1WQ7\&q=85\&s=19444a0aeb790c873b3fe713555b1562)

      The template is downloaded.
   2. Open the Template and fill the details.
      1. Enter **primary ID** of the user whom you want to migrate under **Primary ID field**.

      2. Enter **connection ID** of the connection to which you want to migrate the user to under **Target Connection ID** field.

         ![How to migrate users in bulk in Tenant... - screenshot 5](https://mintcdn.com/oloid-999c42b2/GCwkwFtUXAup1WQ7/images/intercom/10435072/image-47e9d544.png?fit=max\&auto=format\&n=GCwkwFtUXAup1WQ7\&q=85\&s=32dafc9fbcb5f63b3da4a89dd3db4fd4)

         > [!NOTE]
         >
         > **Note:** You must ensure that the **Primary ID** and **Target Connection ID** fields are filled accurately with appropriate data.

      3. Save the File.
   3. Drag and drop or upload the file to the Migrate Users pop-up box.
   4. Click **Upload File & Migrate**.

      ![How to migrate users in bulk in Tenant... - screenshot 6](https://mintcdn.com/oloid-999c42b2/GCwkwFtUXAup1WQ7/images/intercom/10435072/1ac5e638-34a1-4377-b22b-c50a4ccd591f-a2f81a34.png?fit=max\&auto=format\&n=GCwkwFtUXAup1WQ7\&q=85\&s=33e5c3715b7ba5c8833fb6d20da8ba2e)

The Users are migrated to the respective connections in bulk successfully. The file is listed in the Migrate Users page.

> [!NOTE]
>
> **Note:** After migration is completed:

* Users lose access to their current endpoints.
* New Supervisors get assigned to the migrated users.

To check the status of the migration in the logs, click on the file link to download the file.

![How to migrate users in bulk in Tenant... - screenshot 7](https://mintcdn.com/oloid-999c42b2/GCwkwFtUXAup1WQ7/images/intercom/10435072/image-366dff5e.png?fit=max\&auto=format\&n=GCwkwFtUXAup1WQ7\&q=85\&s=1c755e60c03ffc69956405937020baf7)

Find the following status for the migrated users.

* **No user found**- No user found is displayed when the user doesn't exists in the portal.
* **Completed**- Completed is displayed when the user exists and migrated to the respective connection successfully.
* **Error**- Error is displayed when the user is either a Tenant Admin or Supervisor or the user who has face uploaded as credential in the Portal.

  ![How to migrate users in bulk in Tenant... - screenshot 8](https://mintcdn.com/oloid-999c42b2/GCwkwFtUXAup1WQ7/images/intercom/10435072/image-bcceeb0b.png?fit=max\&auto=format\&n=GCwkwFtUXAup1WQ7\&q=85\&s=849ceac67e831b881238a4a0862a1050)