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

Note: Coming from Hipchat? There’s an import guide just for you! Take a look at 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 like. Bear 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 be displayed as bot messages instead.)
  • Choose not to import the member or their messages at all

Note: Members without an email address will be imported to Slack as bot users. You can leave them as they are or create Slack accounts for them if you 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, Hall, Chatwork or a CSV or text file, click Choose file, attach your file and then Click Start import. For Flowdock, authenticate your account to begin your import. For Campfire, enter your Campfire URL and token. 


Once your import’s ready, you’ll receive an email and a 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’s ready! Now it’s time to map your imported members and message history into your Slack workspace:

  1. Locate and open your confirmation email, then click Continue your import. Alternatively, 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 you can manually make adjustments if we didn’t get it right. 
  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. 

Bear in mind: You can cancel an import in progress or execute a rollback once it’s complete and then start again. Click Cancel or Start rollback from the Import data page of the service you’ve imported from.

Who can use this feature?
  • Workspace owners and Admins can access this feature. 
  • Available on free and paid subscriptions.

Related articles

Recently viewed articles