Skip to content

Import from Slack

You can import your current workspace into a Zulip organization. It’s a great way to preserve your workspace history when you migrate to Zulip, and to make the transition easy for the members of your organization.

The import will include your organization’s:

  • Name and Logo
  • Message history, including attachments and emoji reactions
  • Users, including names, emails, roles, avatars, time zones, and custom profile fields
  • Channels, including all user subscriptions
  • Custom emoji

To import your Slack organization into Zulip, you will need to take the following steps, which are described in more detail below:

  1. Export your Slack data.
  2. Import your Slack data into Zulip.
  3. Clean up after the Slack export.
  4. Get your organization started with Zulip!

Import your organization from Slack into Zulip

Section titled “Import your organization from Slack into Zulip”

Slack’s data export service allows you to export all public channel messages, including older messages that may no longer be searchable under your Slack plan.

Unfortunately, Slack only allows workspaces that are on the Business+ or Enterprise Grid plans to export private channels and direct messages. Slack’s support has confirmed this policy as of August 2022.

Owners of Business+ or Enterprise Grid workspaces can request special access in order to export direct message data.

  1. Make sure that you are an owner or admin of your Slack workspace. If you are one, the Slack web application will display that in your profile, in a banner covering the bottom of your avatar.
  2. Export your Slack message history. You should be able to download a zip file with your data a few minutes after you start the export process.
  1. Make sure that you are an owner or admin of your Slack workspace. If you are one, the Slack web application will display that in your profile, in a banner covering the bottom of your avatar.
  2. Create a new Slack app. Choose the “From scratch” creation option.
  3. Create a bot user, following the instructions to add the following OAuth scopes to your bot:
    • emoji:read
    • users:read
    • users:read.email
    • team:read
  4. Install your new app to your Slack workspace.
  5. You will immediately see a Bot User OAuth Token, which is a long string of numbers and characters starting with xoxb-. Copy this token. It grants access to download user and emoji data from your Slack workspace.

To start using Zulip, you will need to choose between Zulip Cloud and self-hosting Zulip. For a simple managed solution, with no setup or maintenance overhead, you can sign up for Zulip Cloud with just a few clicks. Alternatively, you can self-host your Zulip organization. See here to learn more.

If you are using Zulip Cloud, we’ll take it from here! Please email support@zulip.com with the following information:

  1. The subdomain you would like to use for your organization. Your Zulip chat will be hosted at <subdomain>.zulipchat.com.
  2. The exported data file containing your workspace message history export.
  1. Your Slack Bot User OAuth Token, which will be a long string of numbers and characters starting with xoxb-.

Whether you are using Zulip Cloud or self-hosting Zulip, here are few notes to keep in mind about the import process:

Once your organization has been successfully imported in to Zulip, you should delete the Slack app that you created in order to export your Slack data. This will prevent the OAuth token from being used to access your Slack workspace in the future.

Once the import process is completed, you will need to:

  1. Configure the settings for your organization, which are not exported. This includes settings like email visibility, message editing permissions, and how users can join your organization.
  2. All users from your previous workspace will have accounts in your new Zulip organization. However, you will need to let users know about their new accounts, and decide how they will log in for the first time.
  3. Share the URL for your new Zulip organization, and (recommended) the Getting started with Zulip guide.
  4. Migrate any integrations.

When user accounts are imported, users initially do not have passwords configured. There are a few options for how users can log in for the first time.

Allow users to log in with non-password authentication

Section titled “Allow users to log in with non-password authentication”

When you create your organization, users will immediately be able to log in with authentication methods that do not require a password. Zulip offers a variety of authentication methods, including Google, GitHub, GitLab, Apple, LDAP and SAML.

You can send password reset emails to all users in your organization, which will allow them to set an initial password.

If you imported your organization into Zulip Cloud, simply email support@zulip.com to request this.

Send password reset emails (self-hosted organization)

Section titled “Send password reset emails (self-hosted organization)”
  1. To test the process, start by sending yourself a password reset email by using the following command:
    ./manage.py send_password_reset_email -u username@example.com
  2. When ready, send password reset emails to all users by using the following command:
    ./manage.py send_password_reset_email -r '' --all-users

Alternatively, users can reset their own passwords by following the instructions on your Zulip organization’s login page.