Import data into Slack
Are you starting a new Slack workspace or looking to merge two existing workspaces? If so, you can use our import tool to upload an export file with member and channel data from one of these sources:
- A CSV or text file
- A third-party app: Hipchat, Stride, Flowdock, Campfire or Chatwork
- Another Slack workspace
For more details, review our Guide to Slack import and export tools.
Note: We don’t fully support imports into Enterprise Grid organisations. As an alternative, you can import data into a separate workspace, then migrate that workspace to your org.
Data you can add to Slack
This depends on where your data is coming from: a third-party app listed above, a different service or another Slack workspace. In most cases, you can import:
All users, their public messages and associated accounts
Public channels, with message history and files included
Note: some of a user's messages may not be imported if the channel they were posted to is not also moved over to Slack.
Using Slack while running an import
If you’re importing into an active Slack workspace, bear the following in mind while the import is running:
- Members can use the workspace as usual.
- Avoid making certain changes (e.g. activating or deactivating members, deleting or renaming channels) to ensure all data copies over properly.
- The amount of data you’re importing determines how long an import will take. Because each import will vary in size (number of channels, users and files), we’re unable to provide a time estimate.
Step 1: Upload your export file to Slack
- From your desktop, click your workspace name in the top left.
- Select Administration, then Workspace settings from the menu.
- Click Import/export data in the top right.
- Click Import next to your import source.
- For Slack, Hipchat, Stride, Chatwork or a CSV or text file, click Choose file, attach your file, then click Start import. For Flowdock, click Authenticate your Flowdock account. For Campfire, enter your Campfire URL and API token.
- Keep the import page open while your file is uploading. You’ll get an email when it’s done and see a prompt to continue on the page. From the email, click Continue your import; from the page, click Next.
Note: If your export file is bigger than 2 GB, you’ll need to upload it to a secure cloud service (Google Drive, Dropbox or Box). Copy the link generated for your file, then paste it into the Direct download link text field to upload it to Slack.
Step 2: Review user import settings and choose which data to add
When importing data to an existing Slack workspace with active members, you'll see additional options for importing users.
User import settings
Merge users and existing Slack workspace members with the same email.
Import as new users and invite them to Slack
Add users as new members and send workspace invitations.
Import as deactivated users
Add users as new members with deactivated accounts. Invitations will not be sent, but users' messages will be added to Slack and associated with their accounts. Once your import is complete, you can reactivate these users' accounts so they can start using Slack.
Don't import these users – just their messages
Users' messages will be imported to Slack and associated with their names, but accounts will not be created for them.
Don’t import these users or their messages
Exclude users, their messages and files from Slack.
Note: Users cannot be imported as guests or merged into existing guest accounts. You can import these users as deactivated users then reactivate them as guest accounts once the import’s finished.
Choose users to import
- Click the arrow icon next to Show users to review users’ pre-selected import settings. To change an individual user’s import setting, open the drop-down menu next to their name.
- Or open the main drop-down menu and select an option to choose one import setting for all users.
- Once you’ve finished, click Next to continue.
Reminder: choosing one import setting for all users may overwrite individual users' settings.
Step 3: Review channel import settings and choose which data to add
As with importing users, you’ll see the option to merge matching public channels if you’re adding data to an existing Slack workspace. If you’ve exported data from a workspace with access to Corporate Exports, you’ll be able to import private channels and direct messages (DMs) when merging two Slack workspaces.
Channel import settings
Create new channels, maintaining privacy
Create channels in Slack and carry over privacy settings from a third-party service.
Create new public channels
Create public channels in Slack regardless of previous channel privacy settings.
Create new private channels
Create private channels in Slack regardless of previous channel privacy settings.
Merge with existing Slack channels
Merge channels with matching names.
Exclude channels, their messages and files from Slack.
Choose channels to add
- Click the arrow icon next to Show channels to review channels’ pre-selected import settings.
- Or open the main drop-down menu and select an option to choose one import setting for all channels.
- Once you’ve finished, click Next to continue.
Note: If an existing private channel in Slack shares the same name as a channel you’re importing, the two won’t be merged. For privacy reasons, a new channel will be created.
Step 4: Review the summary and start your import
Now you’re ready to import your data into Slack. Bear in mind that large imports take time and could temporarily affect your Slack app’s performance.
- Review the information in your import summary and make sure everything looks right.
- Click Start import.
- Once your import has finished, you’ll receive a confirmation email.
To roll back an import, use the Reverse import button. This action will remove imported channels and messages from your Slack workspace, but not members.
- Workspace owners and admins
- Free, Standard and Plus subscriptions