Pipeline status emails

{{< details >}}

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

{{< /details >}}

You can send notifications about pipeline status changes in a group or project to a list of email addresses.

Pipeline notifications triggered by blocked users are not delivered.

Enable pipeline status email notifications

Prerequisites:

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

To enable pipeline status emails:

1. In your project or group, in the left sidebar, select Settings > Integrations.
2. Select Pipeline status emails.
3. Ensure the Active checkbox is selected.
4. In Recipients, enter a comma-separated list of email addresses. Invalid email addresses are automatically filtered out and will not receive notifications.
5. Optional. To receive notifications for broken pipelines only, select Notify only broken pipelines.
6. Optional. To receive notifications only when a pipeline's status changes, select Notify only when status changes.
7. Select the branches to send notifications for.
8. Select Save changes.