> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack subscriptions

> Get status page updates in the Slack channels where your team already works.

Anyone can subscribe a Slack channel to a public status page. They install the **Status pages via incident.io** app into their workspace, pick a channel, and each incident and maintenance is posted there as soon as it's published, with later updates in a thread. If you own the status page, see [Slack subscribers on your status page](#slack-subscribers-on-your-status-page).

## Subscribe a channel

1. On the status page, select **Subscribe to updates** and open the **Slack** tab
2. Select **Subscribe via Slack**
3. On Slack's install screen, choose the channel for updates and allow the app

![The Subscribe to updates dialog on a status page, with the Slack tab open and the Subscribe via Slack
button](https://mintcdn.com/incidentio-18bb4170/fjvOemrPwTa8rl2o/images/status-pages/slack-subscriptions/subscribe-slack-tab.png?fit=max\&auto=format\&n=fjvOemrPwTa8rl2o\&q=85\&s=b9e2d0e6de5e5b6749eaa873270b69d7)

The app posts a welcome message in the channel, and you're taken back to the status page to choose which updates the channel gets: **All components**, or **Specific components** if you only care about some of them.

![The status page after subscribing: Updates post to #hyperpayments-status in Slack, with Specific components selected and Website and API ticked](https://mintcdn.com/incidentio-18bb4170/fjvOemrPwTa8rl2o/images/status-pages/slack-subscriptions/manage-subscription.png?fit=max\&auto=format\&n=fjvOemrPwTa8rl2o\&q=85\&s=2a9f04064ecff169773c05b629367425)

> [!TIP]
>
> Installing apps in your Slack workspace may require admin approval.

A Slack subscription follows the whole page, even when you subscribe from an incident's page: the channel gets that incident and every future incident and maintenance. On a status page with sub-pages, subscribe from the sub-page you want updates for.

### Private channels

To post in a private channel, the app needs to be in it. If it isn't, the welcome message asks you to invite it, and updates start once you do.

## What gets posted

Each incident or maintenance starts a thread in the channel, and later updates reply in that thread. Posts link to the incident on the status page, and every post has a **Manage subscription** link.

The first post for an incident in Slack, with its status, impact, affected components and a View incident button

By default, these updates also show in the channel itself:

* The update that resolves an incident
* Every maintenance update
* Write-ups

To show every update in the channel instead, open the app's **Home** tab in Slack and, under **Updates in the channel**, choose **Every update**. The setting applies to every subscription in your workspace, and anyone in the workspace can change it.

![The Settings section of the app's Home tab in Slack, with Updates in the channel set to When an incident starts and ends](https://mintcdn.com/incidentio-18bb4170/fjvOemrPwTa8rl2o/images/status-pages/slack-subscriptions/app-home-settings-light.png?fit=max\&auto=format\&n=fjvOemrPwTa8rl2o\&q=85\&s=4fd6639ec9a2228df5398ba10e0bdfab)

## Manage a subscription

Select **Manage subscription** on any post, or from the app's **Home** tab, which lists the subscriptions in channels you're a member of. Sign in with Slack, and from there you can change components or unsubscribe the channel. Only members of the subscribed channel can manage its subscription.

Archiving or deleting the channel, or uninstalling the app, ends its subscriptions.

## Slack subscribers on your status page

Slack subscriptions are available on public status pages that accept subscriptions to the whole page, with nothing to turn on. Customer status pages don't offer them.

Slack posts follow the same rules as email and SMS: subscribers only hear about an update when you choose to notify subscribers, and only for the components they follow.

In Slack, you make this choice on the **Review incident** step of `/inc sp`. The subscriber count there includes Slack channels.

![The Review incident step in Slack for a HyperPayments update, with Notify subscribers selected and a count of active subscribers](https://mintcdn.com/incidentio-18bb4170/fjvOemrPwTa8rl2o/images/status-pages/slack-subscriptions/review-notify-subscribers.png?fit=max\&auto=format\&n=fjvOemrPwTa8rl2o\&q=85\&s=9055c3eddf871ae36f98aeb1164023f5)

### See and remove Slack subscribers

Slack subscribers are listed alongside email and SMS subscribers in your status page's **Subscriptions** settings, on the **Slack** tab under **Subscribers**. Each row shows the workspace, the channel and the components it follows. Channel names are only shown for your own Slack workspaces.

![The Slack section and the Slack tab under Subscribers, with one subscribed channel showing its workspace, hidden
channel name, subscription date and components](https://mintcdn.com/incidentio-18bb4170/fjvOemrPwTa8rl2o/images/status-pages/slack-subscriptions/slack-subscribers.png?fit=max\&auto=format\&n=fjvOemrPwTa8rl2o\&q=85\&s=29fe7b93ece7453b9d3a105be853b82f)

A **Not invited** badge marks a private channel that hasn't invited the app yet, so it won't get updates until someone does.

Remove a single channel from its row, or use **Remove all** (or **Remove matching** with filters applied). **Export CSV** downloads the list.

### Configure Slack messages

In the **Slack** section of the **Subscriptions** settings, select **Configure** next to **Messages** to preview posts and choose how they appear.

* **Preview**: pick an example, or one of your page's recent incidents, to see the posts a subscribed channel would get
* **Display name**: the name posts appear under. Defaults to your status page's name. Sub-page names are added automatically
* **Icon**: a square PNG at least 512 x 512px. Defaults to your status page's favicon, or the incident.io icon if the page has none

![The Configure Slack messages drawer, with Display name and Icon on the left and a preview of the example incident's
first post on the right](https://mintcdn.com/incidentio-18bb4170/fjvOemrPwTa8rl2o/images/status-pages/slack-subscriptions/configure-slack-messages.png?fit=max\&auto=format\&n=fjvOemrPwTa8rl2o\&q=85\&s=974d29f8088d557555bda4a547fa4b8b)

Custom display names and icons are available on the Pro and Enterprise plans.

## Moving from the Slack RSS feed

Before the app, the **Slack** tab on a status page gave you a `/feed subscribe` command to add the page's RSS feed to a channel. Feeds set up that way keep working, but the app posts as soon as an update is published, keeps each incident in its own thread, and lets the page owner see the subscription.

To switch, subscribe the channel with the app, then remove the old feed from the channel in Slack.

## FAQs

> [accordion] Can I subscribe a Slack Connect channel?
>
> Yes, if you install the app from the workspace that created the shared channel. Slack only shows a shared channel on
> the install screen to that workspace.

> [accordion] Can I subscribe a channel to a single incident?
>
> No. A Slack subscription follows the whole page. To narrow it down, choose **Specific components** when you manage
> the subscription.

> [accordion] Can I subscribe more than one channel?
>
> Yes. Subscribe each channel separately from the status page's **Slack** tab. The sign-in screen that **Manage
> subscription** opens also has a **Subscribe another channel** link.

> [accordion] Why isn't my private channel getting updates?
>
> The app needs to be in a private channel to post there. Invite it to the channel, and new updates will start
> posting.
