Import from Slack

ClickUp Chat can replace Slack and introduce ClickUp AI task management and message creation to your conversations! Import your Slack channels, users, and communication history when you move to ClickUp Chat.

You can import from Slack on all ClickUp plans with access to ClickUp Chat

There is a limit of 10,000 messages per Slack channel for importing via file upload or API. The newest through the oldest messages will be imported until that limit is reached. 

Feature availability and limits vary by plan and user role. Learn more

What data imports?

The table below displays what data does and does not import from Slack.

Does import Does not import
Public Slack channels Private Slack channels
Threads Saved messages
Replies Direct messages
Threads and replies from deactivated Slack accounts Pinned messages
Reactions to messages  
Slack events  
SlackBots (imported as ClickBots)  
Mentions  
Followers  
Users (optional) User groups
Attachments (optional)  

Reactions (optional)

Custom emojis can only be imported via the API method. 

 

Rich text:

  • Bold
  • Italics
  • Strikethroughs
  • Hyperlinks
  • New lines
  • Ordered lists
  • Bulleted lists
  • Code blocks 
 

Start your import

To start your import from the imports page:

  1. In the upper-left corner, click your Workspace avatar and select Settings.
  2. In the All settings sidebar, select Imports / Exports.
    • If your Workspace doesn't have an import or export history, the Select source of import page opens. In the Import from apps section, select Slack.
    • If your Workspace has an import or export history, the Imports / Exports page opens. Select Import Items. On the Select source of import page, select Slack.
      Screenshot of the Select source of import page highlighting the Slack option.

Select the import source

After starting your import from either the Imports page or Chat, you'll select the import method. 

  1. Choose one of these two options:
    • Upload: Upload a zip file. 
      Because of Slack's new rate-limiting policy, we encourage you to upload a file rather than using the API.
    • API: Upload via the API.
      Custom emojis can only be imported via the API method. 
      Screenshot of the Slack import preparation page highlighting the Upload and API options.
  2. Click Next.

Export your data from Slack 

To export your data from Slack, you must be a Slack workspace owner or admin. 

The next steps differ, depending on whether your import source is Upload or API. For more info, check out Slack's article on exporting your workspace data

Upload

After selecting upload, you'll provide your Slack export file. 

To upload a Slack export zip file:

  1. On the Select your Slack export file page, attach the Slack export file.
  2. Click Next.
  3. You're directed to the Upload completed page.
  4. Click Next.

API

To export from Slack via API:

  1. A pop-up will display to grant ClickUp access.
    • If you have more than one Slack account, you may need to select the correct account from the dropdown in the upper-right corner of the pop-up.

      Screenshot of the Slack pop up that displays when exporting data via API.

  2. Due to the Slack Marketplace app guidelines, at the top of the pop-up, a banner reads, This app is not approved by Slack. Scroll down and click Allow, and the Slack Importer will begin your import.

Import channels

Private channels won't import. To include them, make them public.

Slack channels are imported into ClickUp as Channels

When importing and mapping data, Slack channels are displayed on the left, and their ClickUp Channels are displayed on the right.

By default, all Slack channels are mapped to a new Chat Channel. To map the Channel to an existing Space in your Workspace:

  1. In the Slack Channels section, click Customize Channels individually.
  2. In the ClickUp Chat Location section, click Customize Spaces individually.
  3. In the ClickUp Chat Location section, to the right of the Slack Channel, click New chat.
    Screenshot of the Import Channels page with Customize Channels individually and Customize Spaces individually expanded.
  4. From the dropdown, select a ClickUp Space. 
    Screenshot of the Import Channels page highlighting the Slack Channel 'new' mapped to the ClickUp Chat Space 'Accounts payable'.
  5. A list with a Chat Channel will be created in that Space.
    • Any Slack channels you do not map will be created in ClickUp as locationless Chat Channels.
  6. Click Next.

Import users

After you've mapped channels, you can import and map users.

By default, Slack users are mapped by email to existing ClickUp users. No email invitation is sent. There's a selection to invite the automatically mapped person as a new user. You can also set that user as inactive or select a different ClickUp user. 

To manually import and map Slack users to ClickUp:

  1. On the Import Users page, in the ClickUp users column to the right of the user name, click the x
    Screenshot of the Import Users page highlighting the x to the right of a user name.png
  2. The user is marked inactive. Click the Inactive user dropdown and choose one of these options:
    • To mark the mapped user as inactive, do nothing. This is a good way to import messages from a teammate who has left your org.
    • Click Inactive user to open the people picker and select a ClickUp user.
    • At the bottom of the people picker, select Invite as new user to invite that person to ClickUp via email. 

      Inviting people to your Workspace may incur charges.

      Screenshot highlighting the Inactive user dropdown with selections to choose an existing ClickUp user and to invite the person as a new user via email.

Options

You have the option to import attachments and reactions from Slack into Chat. When using the API method, you also have a message history option. 

Attachments

Choose if you want to include attachments in your import from Slack.

Reactions

Choose if you want to include reactions in your import from Slack.

After selecting your options, in the lower-right corner of the Options page, click Import.

Finish the import

You'll be redirected to the Import / Export page, where you can track the progress of your import. You can continue to use your Workspace while you wait for the import to complete.

  • You can click Cancel Import to cancel it.
  • The import will show Completed when it is finished.

Screenshot showing a completed Slack import in the History table of the Imports Exports page.

Manage your imports

The History table on the Imports / Exports page provides info about each import. Learn how to manage your imports using this info.

Import speed

Import time varies depending on the number of channels, users, and attachments, as well as the strength of your internet connection.