> For the complete documentation index, see [llms.txt](https://docs.statuspal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.statuspal.io/platform/integrations/slack-notifications.md).

# Slack Notifications

Allow your status page subscribers to receive incident and maintenance notifications directly in their Slack workspace.

{% hint style="info" %}
As a status page admin, enable Slack subscriptions under <mark style="background-color:green;">Subscriptions > Sub. Settings</mark> before your customers can subscribe.
{% endhint %}

## Enable Slack subscriptions (admin)

1. In your status page admin sidebar, click **Subscriptions**, then **Sub. Settings**.
2. Check **Enable Slack subscriptions** and click **Update**.\
   \
   ![Enable Slack subscriptions setting](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-7fe55f642bbcb7aa5c465a26e0e7dff97f8c7c3c%2Fnotifications-slack-enable-setting.png?alt=media)

## How subscribers connect Slack

Once enabled, subscribers will see an **Add to Slack** button in the **Subscribe to Updates** modal on your status page.

![Add to Slack button in subscribe modal](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-29a1d7383634437b0a2d957c5fbf3fa228ed8217%2Fnotifications-slack-subscribe-modal.png?alt=media)

Clicking it takes them through a short OAuth flow to connect their Slack workspace:

![Slack workspace connection screen](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-9a66ae51ca48c4207588d3258995d1e72463a2a2%2Fnotifications-slack-oauth-connect.png?alt=media)

Statuspal only requests the minimum permissions necessary and does not store personal information.

![Slack OAuth permissions](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-24b3469e64e1b7ffe366cd5cefbd0829869c8702%2Fnotifications-slack-oauth-permissions.png?alt=media)

After authorising, subscribers choose the Slack channel where they'd like to receive updates. They can revisit the link at any time to change the channel or cancel their subscription.

![Slack channel selection](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-badbfb1bf07afc85789c9afce156dbcb40c39e5e%2Fnotifications-slack-channel-select.png?alt=media)

## Sending notifications

When creating or updating an incident, check **Notify Slack subscribers** to send the update to all Slack subscribers.

![Notify Slack subscribers checkbox](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-ce1932237a3250fa9499ea7118785f1f11f7874c%2Fnotifications-slack-notify-checkbox.png?alt=media)