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

# Migration

> Import contacts, WhatsApp numbers, labels, custom fields, and team members from another platform.

## What is this?

The **Migration** tab imports your data from another supported platform into this workspace, so you don't start from an empty account.

## What can I do here?

* Choose a **migration source** (the platform you're moving from)
* Import **WhatsApp Number**, **Contacts**, **Contact Enrichment**, **Labels**, **Custom Fields**, and/or **Team Members**
* Watch progress in real time and **Cancel** while it runs

## How to use it

**1. Choose the source**

Under **Import from another platform**, choose a **migration source** from the dropdown. Sources are set up by your platform administrator — if none are listed, ask your admin to configure one.

![The Migration tab with the migration source dropdown selected](https://mintcdn.com/onexpressbot/a-TbqObjJoL_p1Fq/images/settings-migration-source.png?fit=max\&auto=format\&n=a-TbqObjJoL_p1Fq\&q=85\&s=f95a19740321d56115d319912f95abcb)

**2. Enter the API key**

Enter your **API key** for that source platform.

**3. Choose what to import**

Under **What to import**, tick the data to bring in.

![The "What to import" checklist of migration options](https://mintcdn.com/onexpressbot/EVcHp7ZAcLgfPt8Q/images/settings-migration-options.png?fit=max\&auto=format\&n=EVcHp7ZAcLgfPt8Q\&q=85\&s=c0727fb51f7c7a3963de72f3204b75e2)

**4. Start the import**

Click **Start Import**. A progress panel shows items processed, succeeded and failed, with a **Cancel** option while it runs.

**5. Check the result**

When it finishes, a completion message says how many items were imported. Any errors are listed below the progress bar.

> [!NOTE]
>
> This tab offers the general "Import from another platform" import. Importing a single specific user account isn't offered here.

## Troubleshooting / Technical Notes

* **No migration sources are listed.** Your platform administrator sets these up — see Migration.
* **The import stopped with errors.** The errors are listed under the progress bar. Fix the cause (for example an invalid key) and run it again.
* **Some items are missing.** Check the **failed** count in the progress panel and the errors listed under it.

## Related docs

* [Settings](https://docs.xpressbot.org/workspace/settings/overview.md)
* [Contacts](https://docs.xpressbot.org/workspace/contacts/overview.md)


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