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

# Connect Slack

> Connect a Slack workspace and channel for release notifications. Enterprise.

> Slack notifications are an **Enterprise** feature (`slack_notifications`).
> Starter and Pro plans receive notifications via email only.

## What you get

* A consolidated Slack message in the channel of your choice when followed
  tools ship new releases.
* Interactive **Acknowledge** and **Snooze 7 days** buttons on each
  notification.
* The `/relnx status <tool>` [slash command](./use-slack-commands).

## Connect

1. **Settings → Integrations → Slack** (or the **Connect Slack** banner on
   your dashboard).
2. Click **Connect to Slack**. You'll be redirected to the Slack OAuth
   consent screen.
3. Pick the workspace, then the channel Relnx should post to.
4. Authorise.

Relnx stores an encrypted Slack access token and the chosen channel ID. You
can disconnect at any time from the same page.

## Pick a channel

The default is the channel you select during OAuth, but you can change it
later:

1. **Settings → Integrations → Slack → Channel**.
2. Pick a different channel from the dropdown (Relnx must be a member of it —
   add `@Relnx` to the channel first).

## Mute Slack but keep email

1. **Settings → Notifications**.
2. Toggle **Slack notifications** off; leave **Email notifications** on.

The reverse — Slack only, no email — also works.

## Permissions used

Relnx requests the minimum Slack scopes needed to list channels and post:

* `chat:write` — post messages
* `chat:write.public` — post to channels Relnx isn't explicitly in
* `channels:read` — list public channels so you can pick one
* `groups:read` — list private channels you've added Relnx to

The `/relnx` slash command is registered at the app level (it isn't an OAuth
scope you grant per workspace). Relnx does **not** read message content.

## Disconnect

**Settings → Integrations → Slack → Disconnect**. The Slack token is deleted
immediately; Relnx will stop posting and the slash command will return
"workspace not connected".

## Troubleshooting

* **Messages aren't arriving**: confirm `slack_notifications_enabled` is on
  (Settings → Notifications) and Relnx is a member of the target channel.
* **`/relnx status` returns "not configured"**: the workspace owner needs to
  reinstall the app from the Slack App Directory listing — Slack rotates the
  signing secret on uninstall/reinstall.

## Related

* [Use Slack commands and buttons](./use-slack-commands)
* [Plans and limits](../reference/plans)