Watch a Merge Request

You can set up a watch on a merge request and get email notifications when a reviewer adds a comment, a user updates files of the review branch, or a reviewer shares a feedback.

Here's how to subscribe to email notifications for merge request updates when you are a reviewer and when you are not:

Action	How To
Merge requests where you’re a reviewer	By default, you get email notifications of merge requests where you’re a reviewer. If you aren’t getting the email notifications, select the Merge Request updates and comments check box in your user preferences page. In the branding bar, click the user avatar, and select Preferences. Click the Notifications tab. Select the Merge Request updates and comments check box, if not selected. To the left of the User Preferences title, click Close to return to the last opened page.
Merge requests where you’re not a reviewer	Open the merge request. Click + Add me. You'll see this button for an open merge request if you're a project member, but neither the submitter nor a reviewer. To stop watching, remove your name from the Watchers list.

Action

How To

Merge requests where you’re a reviewer

By default, you get email notifications of merge requests where you’re a reviewer. If you aren’t getting the email notifications, select the Merge Request updates and comments check box in your user preferences page.

In the branding bar, click the user avatar, and select Preferences.
Click the Notifications tab.
Select the Merge Request updates and comments check box, if not selected.
To the left of the User Preferences title, click Close to return to the last opened page.

Merge requests where you’re not a reviewer

Open the merge request.
Click + Add me. You'll see this button for an open merge request if you're a project member, but neither the submitter nor a reviewer.

To stop watching, remove your name from the Watchers list.

Note:

A merge request in Draft state has muted update notifications until it is set to the Open state.

Merge Request Email Notifications

If you're a reviewer, requester, or watcher, you'll receive email notifications when the merge request is created or updated. A notification of the event will also appear in the Recent Activity feed on the Project Home page.

Email notifications for a single merge request share the same subject line for easier reading when your inbox is grouped by subject.

Some events that send notifications are:

Merge request is created
Additional source code changes are committed to the review branch and pushed to the upstream
A general comment is added
An attachment is added
An issue is linked
A build job is linked
An inline comment is published
Reviewers are added or removed
Merge request is approved or rejected
Merge request is closed or merged

Note:

If you see the "E-mail address of PersonIdent must not be null" error message when you create or update a merge request, make sure that your user email address has been verified. Access your profile, verify your user email address, and retry the merge request. See Configure Your Global Email Notifications to see how to access your user profile and configure these notifications.