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
  • A third-party app: HipChat, Flowdock, Campfire, or Chatwork

Note: Coming from Hipchat? There's an import guide just for you! Check out Import Hipchat Data to Slack to learn more.


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.

Members

Messages

Invite as many or as few of your former members to Slack as you'd like. For each one, you can do the following:

  • 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 (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, whether from a Slack workspace or third-party app. 


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, Hall, 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 can access this feature. 
  • Available on free and paid plans.

Related Articles

Recently Viewed Articles