Data Migration

Prev Next

Rocket.Chat lets you import workspace data from supported external sources so you can move users, channels, and message history into your workspace.

To open the import tools in Rocket.Chat:

  1. Go to Manage Screenshot 2025-12-23 130522.png > Workspace > Import.

  2. Click Import New File.

  3. Select the Import Type that matches your source data.

Before you begin

Before starting any migration:

  • Confirm you have permission to export data from the source platform.

  • Confirm you have permission to import data into Rocket.Chat.

  • Test the process with a small sample before importing a full production export.

  • Review file size and formatting requirements before upload.

  • Plan time to validate users, channels, and messages after the import completes.

Supported migration paths

Choose the migration method that matches your source platform:

Slack

Use the Slack importer to migrate workspace data from Slack exports. Rocket.Chat supports importing full Slack workspace exports and Slack users from CSV.

CSV

Use the CSV importer when you want to import structured data using Rocket.Chat’s required ZIP format. This is the best option for custom migrations and unsupported platforms after you transform the source data into Rocket.Chat’s CSV structure.

Mattermost

Rocket.Chat does not currently support Mattermost as a built-in importer in the current migration UI or Import API. For Mattermost migrations, convert your export into Rocket.Chat’s supported CSV format, then import it as a CSV package.

Next steps

Open the guide for your source platform: