Import message history

Are you starting a new Slack workspace or combining two together? If so, you can use the import tool to pull existing messages and members from one of these sources: 

  • Another Slack workspace (See Merge Slack workspaces)
  • A CSV or text file (UTF-8 BOM files not supported)
  • A third-party app: HipChat, Flowdock, Campfire, or Chatwork

Coming from Hipchat or Stride? We have import guides just for you! Check out Import Hipchat Data to Slack or Import Stride data to Slack to learn more.

Note: We don't yet support imports to an Enterprise Grid org. As an alternative, you can import data to a workspace, and migrate that workspace to your Enterprise Grid org.

Step 1: Plan your import

Before you get started, it's helpful to understand exactly what can be imported into Slack. We've broken this down for you below.



Invite as many or as few of your former members to Slack as you'd like. Keep in mind that invitation will expire in 24 hours, or 72 hours if your Slack workspace has SSO enabled.

For each person you import, you can do the following:

  • Merge member accounts with a matching email address
  • Create a Slack account and invite the member to your workspace
  • Create a disabled account and invite the member to join later
  • Import a member's messages, but choose not to invite the person to your workspace (This excludes a member's direct messages, files, and @mentions. Messages will display as bot messages instead.)
  • Choose not to import the member or their messages at all

Note: Members with no email address will be imported to Slack as bot users. You can leave them as is, or create Slack accounts for them if you'd like.

When mapping messages to Slack, you can choose where they should go, channel by channel. You can do the following:

  • Map imported content to a new or existing public channel
  • Map imported content to a new private channel (that you've joined)
  • Choose not to import certain messages to Slack

Note: It's not possible to import content from direct messages or private channels from a Slack workspace, or most third-party apps. 

Step 2: Start your import 

  1. From your desktop, click your workspace name in the top left.
  2. Select Administration, then Workspace settings from the menu.
  3. Click Import/Export Data in the top right.
  4. Click Import next to the service you’re importing from.
  5. For Slack, Hipchat, Stride, Chatwork, or a CSV or text file, click Choose File, attach your file, then Click Start Import. For Flowdock, authenticate your account to begin your import. For Campfire, enter your Campfire URL and token. 

When your import is ready, you'll get an email and Slackbot message. 💌

Warning: Please do not edit the .zip, .csv, or .txt file before importing to Slack — this causes errors during the import process.

Note: Large imports may take time and could temporarily affect your Slack app's performance. You can start one import per hour.

Step 3: Map your import 

Hooray, your import is ready! Now it's time to map your imported members and message history into your Slack workspace:

  1. Locate and open your confirmation email and click Continue your import. Or, from the Import Data page, click Information required.
  2. Decide what data to import and where it should go. Members and messages are automatically mapped for you, but in cases where we didn't get it right, you can manually make adjustments. 
  3. Click Save Changes
  4. When you're ready, select Yes, proceed with import.

Once your import has completed, you'll receive a confirmation email. 

Keep in mind: You can cancel an import in progress, or rollback once it's complete, and start again. Click Cancel or Start Rollback from the Import Data page for the service you've imported from.

Who can use this feature?
  • Workspace Owners and Admins
  • Free, Standard, Plus, and Enterprise Grid plans

Related Articles

Recently Viewed Articles