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

# Discord

> Capture messages from Discord servers for analysis

The Discord integration captures messages from your Discord servers and feeds them into Modem for analysis. It's designed for products and companies that engage their user community on Discord.

<Info>
  The Discord integration is currently capture-only. Unlike the [Slack integration](/integrations/slack), you can't interact with the
  Modem Agent from Discord yet. Follow the [Modem X account](https://x.com/modemdev) or [blog](https://modem.dev/blog) for updates.
</Info>

## Prerequisites

* Permission to add bots to the Discord server you want to connect
* Owner or admin role in your Modem organization

## Setup

<Steps>
  <Step title="Start the connection">
    Go to **Settings** → **Integrations** → **Discord** in your Modem dashboard and click **Connect Discord**.
  </Step>

  <Step title="Authorize the bot">
    You'll be redirected to Discord to authorize the Modem bot. Select the server you want to connect and click **Authorize**.
  </Step>

  <Step title="Subscribe to channels">
    Back in Modem, you'll see a list of channels from your server. Toggle on the channels you want Modem to monitor. See [Choosing
    Channels](#choosing-channels) below.
  </Step>

  <Step title="Wait for sync">
    Modem will backfill up to 30 days of message history from your selected channels, then listen for new messages in real time.
  </Step>
</Steps>

## Choosing Channels

Channels are not monitored by default. You subscribe to individual channels from **Settings** → **Integrations** → **Discord**, where each channel has a toggle. When you subscribe to a channel, Modem automatically starts a backfill of recent history.

Supported channel types:

* Text channels
* Forum channels (each post becomes a trackable conversation with its replies)
* Announcement channels

Subscribing to a channel also captures all threads within it.

### Recommended Channels

* `#support` or `#help`: Community support requests
* `#feedback` or `#suggestions`: Feature requests and ideas
* `#bugs` or `#bug-reports`: User-reported issues
* Forum channels for structured discussions and Q\&A

### Channels to Avoid

* Team-only or moderator channels (unless relevant)
* Bot command channels
* Off-topic or meme channels (high noise, low signal)

<Tip>Start with a few key channels and expand based on what's useful. You can adjust channel selection anytime.</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Bot isn't capturing messages">
    * Verify the bot has been added to your server - Check that the channel is toggled on in **Settings** → **Integrations** →
      **Discord** - For private channels, ensure the bot role has permission to view the channel
  </Accordion>

  <Accordion title="Can't see some channels">
    The bot can only see channels it has permission to access. Check: - Channel-specific permission overrides - Category permissions -
    Role permissions for the Modem bot
  </Accordion>

  <Accordion title="Missing user information">
    Discord doesn't expose user email addresses through its API. Person profiles will include username and display name, but not email.
  </Accordion>

  <Accordion title="Backfill is taking a long time">
    Backfills process channels sequentially with delays between each to avoid Discord rate limits. High-volume channels with 30 days of
    history may take several minutes. Check backfill status in **Settings** → **Integrations** → **Discord**.
  </Accordion>
</AccordionGroup>

## Disconnecting

To disconnect a Discord server:

1. Go to **Settings** → **Integrations** → **Discord**
2. Click **Disconnect** next to the server

To fully remove the bot from your Discord server:

1. Open your Discord server settings
2. Go to **Integrations** → **Bots**
3. Find Modem and click **Remove**

Historical data remains in Modem after disconnecting.