Emails on push

{{< details >}}

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

{{< /details >}}

Use emails on push to receive email notifications for changes pushed to your GitLab project. You can select the push events that trigger these notifications.

With emails on push, you can specify a list of email addresses to receive commits and diffs for each push.

Set up the integration

Prerequisites:

• You must have the Maintainer or Owner role for the project.

To set up emails on push:

1. In the top bar, select Search or go to and find your project.

2. Select Settings > Integrations.

3. Select Emails on push.

4. Under Enable integration, select the Active checkbox.

5. In Recipients, enter a list of email addresses separated by spaces or newlines. Invalid email addresses are automatically filtered out and do not receive notifications.

6. Configure the following options:

   • Push events - Email is triggered when a push event is received.
   • Tag push events - Email is triggered when a tag is created and pushed.
   • Send from committer - Send notifications from the committer's email address if the domain matches the domain used by your GitLab instance (such as [email protected]).
   • Disable code diffs - Don't include possibly sensitive code diffs in notification body.