Import Hipchat data into Slack

Welcome to Slack! This guide will help you import your data from Hipchat into Slack. Before getting started, you’ll need to create a Slack workspace if you’re new or sign in to your workspace if you already have one.

How Slack imports work:

  • Already got an active Slack workspace? We’ll automatically try to pair matching data to make it easier to merge users and rooms and keep statuses (e.g. active, deactivated, public, private) intact.
  • Whether you’re new to Slack or not, you’ll have the option to change pre-selected import settings for users and rooms so your workspace is set up exactly the way you want.
  • We don’t support imports into Enterprise Grid orgs. As an alternative, you can import data into a separate workspace, then migrate that workspace to your org.

Need help? Our support team are here to answer questions or lend a hand if you get stuck along the way.


Step 1: Download a copy of your group’s archive

Your Hipchat archive is a single file – with all of your group’s users, rooms and direct messages – that you’ll use to add your data to Slack. To download your archive:

  1. Depending on which Hipchat version you use, follow the steps in Atlassian’s export guide for Hipchat Cloud or Hipchat Server/Data Center.
  2. Make a note of the passphrase you entered for your export, as you’ll need it for the next step.

Tip: get more details about migrating from Hipchat to Slack in our FAQs and developer guide for migrating apps!


Step 2: Upload your archive to Slack

  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.
  4. Next to Hipchat or Stride, select  Import.
  5. Click upload it directly to select your archive file. Make sure you don’t modify the filename or its contents before uploading (you’ll get a chance to choose which data you import shortly).
  6. Enter your passphrase, then click Upload.
  7. Keep the window open while your file is uploading. Once it’s finished, you’ll get an email letting you know. Click Continue your import from the email to move on to Step 3.

Uploading a large file? If your archive is larger than 2 GB, upload it to an online storage service (such as Google Drive, Dropbox or Box), then paste the link into the Direct download link text field.


Step 3: Review import settings and add users

Now you’re ready to add users from your archive to Slack. Whether or not you see certain import options depends on the status of your workspace.

  • New Slack workspace:
    You haven’t invited anyone to join your Slack workspace yet.
  • Existing Slack workspace:
    You’ve added members to your workspace and they’re actively using Slack.

Your import options are:

  • Merge users
    Merge matching Hipchat users and Slack members with the same email address.
  • Import as new users and invite them to Slack
    Add Hipchat users as new Slack members and invite them to your workspace.
  • Import as deactivated users
    Users’ messages will be added to Slack and associated with a deactivated account. Once you’re ready, you can reactivate these users so they can start using Slack.
  • Don’t import these users – just their messages
    Users’ public messages will be added to Slack and associated with their names, but accounts will not be created for them. Their direct messages and files will not be imported.
  • Don’t import these users or their messages
    Exclude users, their messages and files from Slack.

To import users, follow these steps:

New Slack workspace

Existing Slack workspace

  1. Click the arrow icon next to Show users to see a list of all users in your archive and their pre-selected import settings.
  2. Review users’ import settings. To choose a different setting for a specific user, open the drop-down menu next to their name and select the one you want.
  3. Once you’ve finished, click Next to continue.
  1. Decide how you want to import users with a matching email address. To choose a different import setting for specific users, click the arrow next to Show users.
  2. Decide how you want to import users without a matching email address. Click the arrow icon next to show users to select a different import setting for specific users.
  3. Click Next to continue.

Tip: To choose one import setting for all users, select the one you want from the main Import users drop-down menu.


Step 4: Review import settings and add rooms

It’s time to add your Hipchat rooms to Slack as channels. As with users, you have the option to merge public rooms and Slack channels with the same name in your workspace.

New Slack workspace

Existing Slack workspace

  1. Click the arrow icon next to Show rooms to see a list of all rooms in your archive and their pre-selected import settings.
  2. Review rooms’ import settings. To choose a different import setting for a specific room, open the drop-down menu next to the name and select the one you want.
  3. Once you’ve finished, click Next to continue.

Note: If an existing private channel in Slack shares the same name with an imported Hipchat room, the two won’t be merged. For privacy reasons, a new channel will be created.

  1. Decide how you want to import rooms with a matching Slack channel. If you like, you can change one or more channels’ privacy settings at this stage.
  2. Choose how you'd like to import rooms with no matching Slack channel. Update privacy settings if you want.
  3. Click Next to continue.


Step 5: Review summary and run import

  1. Review your selected data to make sure everything looks alright.
  2. If you need to make any final changes to your import, click Edit. This will take you back to Step 4 in the import workflow, where you can update channel data. To modify users, select Choose users to import.
  3. Click Next to return to the import summary.
  4. Once you’re ready to import your data, click Import. The import progress bar will indicate how much of your data has been imported. You’ll also see Importing… next to the data currently being moved into Slack.
  5. We’ll send you an email once your import is complete.

Troubleshooting imports

If your import stops before it’s completed, please contact us so we can help get things back on track.

To roll back a completed import, click Reverse import. This action will remove imported channels and messages from your Slack workspace, but not members.

Who can use this feature?
  • Workspace owners and admins
  • Free, Standard and Plus subscriptions