> ## 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 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.

> [!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.

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.

## 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.

### 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.

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

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. After subscribing one, select **Subscribe another channel** on the manage
> page.

> [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.
