# Discord Integration (/docs/guides/discord-integration)



Receive deployment, preview, and code review notifications directly in your Discord channels.

## How It Works [#how-it-works]

Rock8Cloud uses a global Discord bot - your organization links its Discord server to the bot via an invite flow. Unlike Slack (which uses OAuth per workspace), the Discord integration uses a single bot that you invite to your server.

## Connect Your Server [#connect-your-server]

1. Go to **Settings** → **Integrations**
2. On the Discord card, click **Add to Discord Server**
3. Select the server you want to add the bot to
4. Authorize the bot's permissions
5. You should see a green "Connected" status with your server name

## Add Notifications to a Project [#add-notifications-to-a-project]

1. Open your project's **Settings** tab
2. Go to **Notifications**
3. Click **Add Channel** → select **Discord**
4. Pick a channel from the dropdown
5. Select which events to receive
6. Click **Create**

For the full list of supported events and webhook setup, see [Notifications](/docs/guides/notifications).

## Disconnecting [#disconnecting]

If you need to disconnect your Discord server:

1. Go to **Settings** → **Integrations**
2. On the Discord card, click **Disconnect**
3. Confirm the disconnection

Your projects keep their Discord notification channels, but nothing is delivered while the server is disconnected. Reconnect the same server and they start working again on their own. Connect a different server and they stay silent, because they point at the old one.

## Troubleshooting [#troubleshooting]

| Problem                       | Solution                                                                                                  |
| ----------------------------- | --------------------------------------------------------------------------------------------------------- |
| Bot not added to server       | Click "Add to Discord Server" and complete the authorization flow                                         |
| Channel not in dropdown       | Ensure the bot has access to the channel. You may need to re-invite the bot if permissions changed        |
| Notifications stopped working | Go to **Settings** → **Integrations** and check the connection status. Disconnect and reconnect if needed |
| Integration not available     | Contact your administrator - Discord integration may not be configured on this server                     |

## Related [#related]

* [Notifications](/docs/guides/notifications) - Full list of events and webhook setup
* [Slack Integration](/docs/guides/slack-integration) - Connect Slack for notifications
* [Teams and Organizations](/docs/guides/teams-and-organizations)
