Slack integration

The Slack integration widget provides a portal into your slack channels which you can view and contribute to through your digital workplace.

The Slack widget on a page.

Sections in this article:


Slack limits the number of API calls that can be made per second from a single source. Including multiple slack widgets on a single page, or having multiple tabs open containing slack widgets may exceed this limit and cause the widgets to stop working. For more information, see Slack's rate limits.

Set up

  1. Place an Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget.
  2. Select the placed widget's Edit button.
  3. Under Integration Library, select Igloo Integration Library.
  4. Select  Slack from the library.
  5. Review and make changes to the settings on the Options and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  6. In the widget editor, select Update to apply your changes.
  7. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.

Approving the Igloo App

The Igloo App is not listed in the Slack App Directory. Depending on the Slack Team's permissions, the Team Owner may need to approve the Igloo App before it can connect to the Slack Team. Signing into the Slack Integration before it has been approved results in the following message:

The unauthorized message.

To approve the Igloo App, the Team Owner or a member who has permission to add Apps, must sign into Slack using the Integration. When signing in they will receive the following Authorization request:

Authorizing your workplace to work with Slack.


Select Authorize to approve the app.

Refer to Slack's article, Manage apps for your workspace, if you encounter issues with authorizing the app.


Setting Descriptions

Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a title for each supported language. 

This field can contain a maximum of 140 characters.

Title link

Enter the URL of a location in your digital workplace. Users who click the widget's title, if it has one, will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter, it will convert to an absolute URL the next time you edit the widget.

This field can contain a maximum of 2,083 characters.


Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.

General options
Setting Description
Channel Name Enter the name of the channel that you would like to be displayed by default through the widget.
Team ID Enter a Team ID which will be used when connecting to Slack. If left blank, users will be prompted for the ID when connecting through the widget for the first time.
Enable Channel Change Select whether users can change channels.
Number of previous messages to show Enter how many recent messages will be shown from the channel history.
Advanced options

Appearance tab

Appearance options
Setting Description

Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets.


Select the height of the widget.

The default value is Auto (leftmost slider position) scales the widget's height to fit its contents. You can use the slider to set a fixed height between 50px to 600px in increments of 50px.

Selecting a height less than what is needed to display its contents results in the widget having a vertical scrollbar.


Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.

Using it


You can see what is posted in your Slack channels through the integration. The feed shows posts and updates automatically when new entries are made from either the widget or other Slack interfaces. Scrolling through previous messages will automatically load additional messages if they exist.

A message in the widget.


Post messages

You can add new messages that include #hashtags, @mentions, and emojis. For more information about formatting your messages, see Slack's article about formatting your messages.

Composing a new message.


Upload files

You can upload files from your computer into slack. These follow the same restrictions as normal file restrictions in Slack. When uploading a file you can include a title and comment that will be published at the same time as the file upload.

The add file button.


Change Channel

If enabled, select which of your existing Slack channels to display in the feed. Use the search option to quickly locate channels in addition to scrolling through the channel list.

Threaded Replies

You can create a reply thread by clicking the speech bubble icon located on a message. Messages with existing threads will contain a View Thread link that can be clicked to view the existing threaded replies.