2020-07-20 21:09:23 +00:00
---
2021-08-02 15:08:56 +00:00
stage: Ecosystem
group: Integrations
2020-11-26 06:09:20 +00:00
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2020-07-20 21:09:23 +00:00
---
2021-02-17 18:09:19 +00:00
# Discord Notifications service **(FREE)**
2018-11-05 01:28:08 +00:00
2020-02-06 15:09:11 +00:00
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/22684) in GitLab 11.6.
2018-11-05 01:28:08 +00:00
2018-11-05 03:47:23 +00:00
The Discord Notifications service sends event notifications from GitLab to the channel for which the webhook was created.
2018-11-05 01:28:08 +00:00
2021-04-14 15:09:04 +00:00
To send GitLab event notifications to a Discord channel, [create a webhook in Discord ](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks )
and configure it in GitLab.
2018-11-05 04:09:05 +00:00
2018-11-05 03:47:23 +00:00
## Create webhook
2018-11-05 01:28:08 +00:00
2018-11-05 03:47:23 +00:00
1. Open the Discord channel you want to receive GitLab event notifications.
2018-11-05 01:28:08 +00:00
1. From the channel menu, select **Edit channel** .
1. Click on **Webhooks** menu item.
2020-12-01 18:09:42 +00:00
1. Click the **Create Webhook** button and fill in the name of the bot to post the messages. Optionally, edit the avatar.
2018-11-05 03:47:23 +00:00
1. Note the URL from the **WEBHOOK URL** field.
1. Click the **Save** button.
2018-11-05 01:28:08 +00:00
2018-11-05 03:47:23 +00:00
## Configure created webhook in GitLab
2018-11-05 01:28:08 +00:00
2018-11-05 03:47:23 +00:00
With the webhook URL created in the Discord channel, you can set up the Discord Notifications service in GitLab.
2018-11-05 01:28:08 +00:00
2020-03-30 21:08:01 +00:00
1. Navigate to the [Integrations page ](overview.md#accessing-integrations ) in your project's settings. That is, **Project > Settings > Integrations** .
1. Select the **Discord Notifications** integration to configure it.
2020-04-15 12:09:18 +00:00
1. Ensure that the **Active** toggle is enabled.
2018-11-05 05:16:34 +00:00
1. Check the checkboxes corresponding to the GitLab events for which you want to send notifications to Discord.
2018-11-05 03:47:23 +00:00
1. Paste the webhook URL that you copied from the create Discord webhook step.
1. Configure the remaining options and click the **Save changes** button.
2018-11-05 01:28:08 +00:00
2020-12-01 18:09:42 +00:00
The Discord channel you created the webhook for now receives notification of the GitLab events that were configured.