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

# Slack

> Get Sentry alerts and manage issues directly from Slack.

The Slack integration connects your Sentry organization to one or more Slack workspaces. You receive formatted issue notifications in any channel, and you can resolve, ignore, and assign issues without leaving Slack.

## What you can do

* Receive structured issue alert notifications in any public or private channel
* Resolve, ignore, or assign Sentry issues using buttons directly in the Slack message
* Unfurl Sentry issue URLs posted in Slack into rich previews with issue context
* Route personal notifications (such as issue assignments) to your Slack DMs
* Configure alert rules that post to specific channels based on conditions like error frequency or environment

## Install the Slack integration

<Steps>
  <Step title="Open Integrations">
    In Sentry, go to **Settings > Integrations** and find **Slack**.
  </Step>

  <Step title="Start installation">
    Click **Install**. A configuration dialog opens.
  </Step>

  <Step title="Authorize with Slack">
    You are redirected to Slack's OAuth page. Select the workspace you want to connect and click **Allow**.

    <Note>
      You need to be a Slack workspace admin, or your workspace admin needs to approve the app, depending on your workspace's app installation policy.
    </Note>
  </Step>

  <Step title="Finish setup">
    After authorizing, Sentry links the workspace to your organization. You can connect multiple workspaces by repeating this process.
  </Step>
</Steps>

## Configure alert rules

Installing the integration alone does not send any notifications. You need to create or update alert rules to route notifications to Slack.

<Steps>
  <Step title="Open project alerts">
    Go to **Settings > \[Project] > Alerts** and click **Create Alert**.
  </Step>

  <Step title="Choose a trigger">
    Select the conditions that should trigger the alert, such as a new issue being created or an issue exceeding an error rate threshold.
  </Step>

  <Step title="Add a Slack action">
    Under **Actions**, select **Send a Slack notification**, then choose your workspace, channel, and the tags you want to include in the message.
  </Step>

  <Step title="Save the rule">
    Give the rule a name and save it. Sentry starts sending matching events to the configured channel.
  </Step>
</Steps>

<Tip>
  Use channel-specific rules to separate noise from signal—for example, send all issues to `#sentry-alerts` but route critical errors directly to `#incidents`.
</Tip>

## Slack notification format

When an alert fires, Sentry posts a message with:

* Issue title and culprit
* Project and environment
* Error frequency and first/last seen timestamps
* Assignee (if set)
* A link to the issue detail page

The message also includes interactive buttons so you can act on the issue without opening Sentry.

## Take action from Slack

Slack messages include buttons that let you:

| Action      | What it does                                                |
| ----------- | ----------------------------------------------------------- |
| **Resolve** | Marks the issue as resolved in Sentry                       |
| **Ignore**  | Ignores the issue (you can specify a duration or threshold) |
| **Assign**  | Opens a picker to assign the issue to a team member         |

<Note>
  To use interactive buttons, your Sentry account must be linked to your Slack identity. Sentry prompts you to link your account the first time you try to take an action. You can also link manually by running `/sentry link` in any channel where the Sentry app is present.
</Note>

## Unfurl Sentry URLs

When someone pastes a Sentry issue URL into a Slack message, the Slack integration automatically expands it into a card showing the issue title, status, assignee, and event count. This works in any channel where the Sentry app has been added.

## Personal notifications

You can receive Sentry notifications in your Slack DMs for events like:

* Issues assigned to you
* Comments on issues you are subscribed to
* Workflow updates on issues you own

To configure personal notifications, go to **User Settings > Notifications** and set the Slack delivery preference for each notification type.

## Troubleshooting

**Notifications are not arriving in the channel.**
Verify that the alert rule is active and that the Slack workspace and channel name in the rule match exactly. Private channels require the Sentry app to be invited to the channel first.

**Interactive buttons show an error.**
Make sure your Sentry account is linked to your Slack identity. Run `/sentry link` in Slack or go to **User Settings > Identities** in Sentry to link accounts.

**The integration is installed but no workspace appears in the alert rule dropdown.**
Try refreshing the Integrations page or reinstalling. If the issue persists, check whether the Sentry app was removed from the Slack workspace.