Help us learn about your current experience with the documentation. Take the survey.

Discord notifications

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

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 text box.
  8. Select Save.

Configure created webhook in GitLab

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. In the left sidebar, select Settings > Integrations.
  3. Select Discord Notifications.
  4. Under Enable integration, select the Active checkbox.
  5. In the Webhook text box, paste the webhook URL you created earlier.
  6. Select the checkboxes corresponding to the GitLab events for which you want to send notifications to Discord.
  7. Optional. For each checkbox you select, enter another Discord webhook URL you have configured to override the URL in the Webhook text box.
  8. Configure the remaining options and select Save changes.

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