Discord notifications

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

The Discord Notifications integration sends event notifications from GitLab to the channel for which the webhook was created.

To send GitLab event notifications to a Discord channel, create a webhook in Discord and configure it in GitLab.

Create webhook

1. Open the Discord channel you want to receive GitLab event notifications.
2. From the channel menu, select Edit channel.
3. Select Integrations.
4. If there are no existing webhooks, select Create Webhook. Otherwise, select View Webhooks then New Webhook.
5. Enter the name of the bot to post the message.
6. Optional. Edit the avatar.
7. Copy the URL from the WEBHOOK URL field.
8. Select Save.

Configure created webhook in GitLab

{{< history >}}

• Event webhook overrides introduced in GitLab 16.3.
• Webhook URL validation introduced in GitLab 18.0.

{{< /history >}}

Prerequisites:

• You must use a Discord URL (https://discord.com/api/webhooks/webhook-snowflake/webhook-token).

With the webhook URL created in the Discord channel, you can set up the Discord Notifications integration in GitLab.

1. In the top bar, select Search or go to and find your project.
2. Select Settings > Integrations.
3. Select Discord Notifications.
4. Ensure that the Active toggle is enabled.
5. Paste the webhook URL that you created earlier into the Webhook field.
6. Select the checkboxes corresponding to the GitLab events for which you want to send notifications to Discord.
7. Optionally for each checkbox that you select, enter a new Discord webhook URL that you have configured to override the default one in the Webhook field.
8. Configure the remaining options and select the Save changes button.

The Discord channel you created the webhook for now receives notification of the GitLab events that were configured.