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

# Discord integration

> Receive GrowthBook event alerts in a Discord channel: create a server webhook, connect it in GrowthBook, and subscribe to the events you care about.

export const ExternalLink = () => {
  return <svg width="13.5" height="13.5" aria-hidden="true" viewBox="0 0 24 24" style={{
    display: "inline-block",
    verticalAlign: "-0.125em",
    marginLeft: "0.15em"
  }}>
      <path fill="currentColor" d="M21 13v10h-21v-19h12v2h-10v15h17v-8h2zm3-12h-10.988l4.035 4-6.977 7.07 2.828 2.828 6.977-7.07 4.125 4.172v-11z"></path>
    </svg>;
};

The GrowthBook Discord integration allows you to receive alerts for the events that you care about in a Discord channel of your choosing.

## Making A Discord Webhook

The first step is to create an event webhook on your discord server:

1. Open your **Server Settings** and head into the **Integrations** tab:
2. Click the **Create Webhook** button to create a new webhook!

<Frame>
  <img src="https://mintcdn.com/growthbook-ea15456d/66H-dO8hZfIFVUdN/static/images/webhooks/discord/discord-new-webhook.png?fit=max&auto=format&n=66H-dO8hZfIFVUdN&q=85&s=8d356ff575cf4518cdc18707c1750efb" alt="" width="2042" height="1706" data-path="static/images/webhooks/discord/discord-new-webhook.png" />
</Frame>

Once your discord webhook is configured, you can copy its url:

<Frame>
  <img src="https://mintcdn.com/growthbook-ea15456d/66H-dO8hZfIFVUdN/static/images/webhooks/discord/discord-copy-webhook-url.png?fit=max&auto=format&n=66H-dO8hZfIFVUdN&q=85&s=4e5bdaa155e6b75bcf123e4270802539" alt="" width="1368" height="1386" data-path="static/images/webhooks/discord/discord-copy-webhook-url.png" />
</Frame>

## Add the Discord integration to GrowthBook

Next step is to login to the GrowthBook app and visit the **Webhooks** tab under **Settings**, also available [here](https://app.growthbook.io/settings/webhooks). You will need privileges to manage webhooks in order for this menu item to be available.

Click the **Create an Event Webhook** button. You should see a modal pop up with some fields for configuring the Discord notification webhook.

<Frame>
  <img src="https://mintcdn.com/growthbook-ea15456d/66H-dO8hZfIFVUdN/static/images/webhooks/discord/new-webhook.png?fit=max&auto=format&n=66H-dO8hZfIFVUdN&q=85&s=ba91a6cafc5b7637dc67d6f2540fbddf" alt="" width="1014" height="1454" data-path="static/images/webhooks/discord/new-webhook.png" />
</Frame>

Then, configure the following:

* **Name**: The name of the integration. In case you have multiple integrations, this can help you tell them apart. This will also show in the contextual text alongside the alerts.
* **Endpoint URL**: Copy and paste the webhook URL provided by your discord app.
* **Payload**: Select the `Discord` payload.
* **Event filters**: You can optionally filter by events you care about. For example, if you only care about when features are deleted, you can choose `feature.deleted` from the list. If you care about all events, leave this blank.
* **Environment filters**: You can optionally choose to filter by environment. For example, if you only want to hear about events that are for the production environment, you can choose `production` from the list. For all environments, leave this blank.
* **Project filters**: You can optionally choose to filter by project. For example, if you have a project named "Onboarding V2" and you only want to alert for that project, you can choose that project from the projects list. For all projects, leave this blank.
* **Tag filters**: You can optionally choose to filter by tag. For all events regardless of tag, leave this blank.

After configuring all the fields, press **Create** to save your new Discord notification webhook.

You can also edit these fields at any point if you make a mistake.

<Frame>
  <img src="https://mintcdn.com/growthbook-ea15456d/66H-dO8hZfIFVUdN/static/images/webhooks/discord/edit-webhook.png?fit=max&auto=format&n=66H-dO8hZfIFVUdN&q=85&s=9e0d7a0275f30dd9cf2b55010445e853" alt="" width="1020" height="1452" data-path="static/images/webhooks/discord/edit-webhook.png" />
</Frame>

### Adding more alerts

If you'd like to be alerted in another Discord channel, you can add another Incoming Webhook in Discord.

Then, you can create new integrations in the GrowthBook dashboard, specifying all of the same information except adding your new webhook URL.

## Testing your alerts

You are now ready to test your alerts. First, you can hit the `Test` button on the webhook settings page. This should trigger a test notification.

Next, perform one of the actions you're watching if you've added Event filters. If you haven't added any event filters, the quickest way to test it's working is to either create a new test feature (then delete it if it's not needed), or toggle an environment on or off for an existing feature.
