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

# Merging Workspaces

> Connect your two separate workspaces into one to centralize your team's communication and data management.

**Access:** Workspace Admins

## **On Mobile (iOS & Android)**

Merging one workspace into another is a two-step process. To initiate the merge, start from the workspace you want to keep and continue using (See step 1). To finalize the merge, the workspace being merged will need to complete the process on their end (See step 2).

### **Step 1: The Workspace That Will Remain Active**

An admin of the workspace that will remain active needs to follow these instructions:

1. Tap the "Admin" tab at the bottom of the screen.
2. Tap "Settings".

![Merging Workspaces screenshot 1](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/1c485083-7895-432a-ad68-d14248804f75.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=ba8720123f94bf0c95a03cf81031a0f7)

3. Tap "Merge workspace".

![Merging Workspaces screenshot 2](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/7888297d-9e3f-4d2d-9cac-213be4bd0804.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=ec0fe0ce5765dc608ede89d72349b8bc)

4. Choose "Merge another workspace into yours".

![Merging Workspaces screenshot 3](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/0b121320-421c-453a-a28b-a10fbd8b8e15.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=555d58ee8229fa9750c3ab3b48a17e7e)

5. Tap "Share merge code".

![Merging Workspaces screenshot 4](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/f40ccc51-d355-462a-bf8a-bd7d543a7eca.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=0d1e3d13df9a509f1327cae7fda31da8)

6. Search for or select the admin of the workspace you want to merge into yours.

**Note:** If you cannot find the admin of the other workspace in the list, you must invite them to a direct message chat first.

7. Tap "Send".

![Merging Workspaces screenshot 5](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/ce07adfd-67cc-4ffa-a3c1-fab45250c853.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=b176e94687ce637183bf497ccfc1ce98)

8. Tap "Confirm" on the pop-up message to approve the merge and "Done" on the finishing screen.

**Note:**

* Make sure to share the code with an Admin in the other workspace.
* Once they use the code, their workspace will merge into yours and this action cannot be reversed.

### **Step 2: The Workspace That Will Be Merged**

After receiving the code, an admin of the workspace that will be merged should follow these steps to complete the process:

1. Tap the "Admin" tab at the bottom of the screen.
2. Tap "Settings".

![Merging Workspaces screenshot 6](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/2038f639-a2e7-4378-b4d1-8fabf71ee973.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=3bca8927a1b7844e9c663cbe2a0fabba)

3. Tap "Merge workspace".

![Merging Workspaces screenshot 7](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/62aab285-524f-47fa-bb7d-fbf555e55cc9.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=df1345a1a738edb0b997589fa325380e)

4. Choose "Enter code to complete merge".

![Merging Workspaces screenshot 8](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/38001745-e5d7-4058-8c22-52e20d685c93.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=bc410a618e67f5499c1f375f4cb60ac8)

5. Type the code you received from the admin of the workspace you want to join.
6. Tap "Confirm"

![Merging Workspaces screenshot 9](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/6d49b331-db78-4aa2-859f-92b5b0f138b6.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=e36608e332f25bfbf1c4f8dde6621de1)

7. Tap "Confirm" on the pop-up message to approve the merge and "Done" on the finishing screen.

**Note:**

* Once complete, your workspace will no longer exist separately and you will receive the name of the workspace you merged into.
* The merge will take place after 24 hours. Once completed, the merge cannot be undone.
* When your workspace is merged into another workspace, any auto domain sign-up settings configured in your workspace will also be transferred over.

## **On Desktop (Windows, macOS, & Web App)**

Merging one workspace into another is a two-step process. To initiate the merge, start from the workspace you want to keep and continue using. To finalize the merge, the workspace being merged will need to complete the process on their end.

### **Step 1: The Workspace That Will Remain Active**

An admin of the workspace that will remain active needs to follow these instructions:

1. Click on "Organization" in the side menu on Windows and Web, or click "Settings" under the "Admin" section on macOS.
2. Scroll to the bottom.
3. Click "Start merging".

![Merging Workspaces screenshot 10](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/53ac30f8-7f69-42fe-a83c-867a8f192472.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=1a846b266d7f1e7575cac00f2720cb8a)

4. Choose "Merge another workspace into yours".

![Merging Workspaces screenshot 11](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/6928b711-105d-4787-8951-7961d6ebb878.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=bd9d73d9c59f43b7e9894dc533f3f77c)

5. Click "Next" on the pop-up message to start the merge.
6. Search for or select the admin of the workspace you want to merge into yours.

**Note:** If you cannot find the admin of the other workspace in the list, you must invite them to a direct message chat first.

7. Click "Send".

![Merging Workspaces screenshot 12](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/0c23d56a-ba48-4b2d-8b02-56f701bfcd87.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=17c5e0babbf006ec80b59770232dcba0)

8. Tap "Confirm" on the pop-up message to approve the merge and "Done" on the finishing screen.

**Note:**

* Make sure to share the code with an Admin in the other workspace.
* Once they use the code, their workspace will merge into yours and this action cannot be reversed.

### **Step 2: The Workspace That Will Be Merged**

After receiving the code, an admin of the workspace that will be merged should follow these steps to complete the process:

1. Click "Organization" in the side menu on Windows and Web, or click "Settings" under the "Admin" section on macOS.
2. Click "Start merging".

![Merging Workspaces screenshot 13](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/4329706d-dbee-47d0-a8b2-68695e25c49e.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=cd32878fcf7e0d3231835d82f0ddf04b)

3. Choose "Enter code to complete merge".

![Merging Workspaces screenshot 14](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/07daac82-338b-4b6d-8fc8-e55f4099cdf4.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=e32130a7365a4f5cc2b741b1f449db89)

4. Type the code you received via email from the workspace you want to be part of.

5. Click "Confirm".

![Merging Workspaces screenshot 15](https://mintcdn.com/zenzap/Xir1Mi-bzi3a1deL/images/knowledge-base/merging-workspaces/71edcd37-0cef-4ffa-abc5-46046eb435d4.png?fit=max\&auto=format\&n=Xir1Mi-bzi3a1deL\&q=85\&s=4cf8ac19548bae5bd17014d083b79e72)

6. Tap "Confirm" again on the pop-up message to approve the merge and "Done" on the finishing screen.

**Note:**

* Once complete, your workspace will no longer exist separately and you will receive the name of the workspace you merged into.
* It will be 24 hours until the workspace is merged.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.