diff --git a/doc/user/profile/notifications.md b/doc/user/profile/notifications.md index 2a6b2767f653315b0755b7a5393dfd46f1475c93..db4d635a8e54b911bc92c27b8a713cfbd2ae8eb4 100644 --- a/doc/user/profile/notifications.md +++ b/doc/user/profile/notifications.md @@ -189,8 +189,8 @@ Users are notified of the following events: | Event | Sent to | Settings level | |------------------------------------------|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------| -| New release | Project members | Custom notification. | -| Project moved | Project members | Any other than disabled. | +| New release | Project members | Custom notification level with **Release is created** selected. | +| Project moved | Project members | Any other than disabled. Custom notification level is **Project is moved**. | | Email changed | User | Security email, always sent. | | Group access level changed | User | Sent when user group access level is changed. | | New email address added | User | Security email, sent to primary email address. | @@ -306,11 +306,12 @@ Learn how to [opt out of all emails from GitLab](#opt-out-of-all-gitlab-emails). {{< history >}} +- Notifications for merge requests you're eligible to approve [introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/12855) in GitLab 16.7 and [renamed](https://gitlab.com/gitlab-org/gitlab/-/issues/465347) in GitLab 17.11. - Service account pipeline notifications [introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/178740) in GitLab 18.1. {{< /history >}} -The following table presents the events that generate notifications for issues, merge requests, and +The following events generate notifications for issues, merge requests, and epics: @@ -318,42 +319,42 @@ epics: | Type | Event | Sent to | |------|-------|---------| | Epic | Closed | Subscribers and participants. | -| Epic | New | Anyone mentioned by username in the description, with notification level "Mention" or higher. | -| Epic | New note | Participants, Watchers, Subscribers, and Custom notification level with this event selected. Also anyone mentioned by username in the comment, with notification level "Mention" or higher. | +| Epic | New | Anyone mentioned by username in the description, with notification level **Mention** or higher. Custom notification level with **Epic is created** selected. | +| Epic | New comment | Participants, watchers, subscribers, and custom notification level with **Comment is added** selected. Anyone mentioned by username in the comment, with notification level **Mention** or higher. | | Epic | Reopened | Subscribers and participants. | -| Issue | Closed | Subscribers and participants. | -| Issue | Due tomorrow. The notification is sent at 00:50 in the server's time zone (for GitLab.com this is UTC) for open issues with a due date of the next calendar day. | Participants and Custom notification level with this event selected. | +| Issue | Closed | Subscribers, participants, and custom notification level with **Issue is closed** selected. | +| Issue | Due tomorrow | Participants and custom notification level with **Issue is due tomorrow** selected. The notification is sent at 00:50 in the server's time zone (UTC for GitLab.com) for open issues with a due date of the next calendar day. | | Issue | Milestone changed | Subscribers and participants. | | Issue | Milestone removed | Subscribers and participants. | -| Issue | New | Anyone mentioned by username in the description, with notification level "Mention" or higher. | -| Issue | New note | Participants, Watchers, Subscribers, and Custom notification level with this event selected. Also anyone mentioned by username in the comment, with notification level "Mention" or higher. | +| Issue | New | Anyone mentioned by username in the description, with notification level **Mention** or higher. Custom notification level with **Issue is created** selected. | +| Issue | New comment | Participants, Watchers, Subscribers, and Custom notification level with **Comment is added** selected. Anyone mentioned by username in the comment, with notification level **Mention** or higher. | | Issue | Title or description changed | Any new mentions by username. | -| Issue | Reassigned | Participants, Watchers, Subscribers, Custom notification level with this event selected, and the old assignee. | -| Issue | Reopened | Subscribers and participants. | -| Merge Request | Closed | Subscribers and participants. | -| Merge Request | Conflict | Author and any user that has set the merge request to auto-merge. | -| Merge Request | [Marked as ready](../project/merge_requests/drafts.md) | Watchers and participants. | -| Merge Request | Merged | Subscribers and participants. | -| Merge Request | Merged when pipeline succeeds | Author, Participants, Watchers, Subscribers, and Custom notification level with this event selected. Custom notification level is ignored for Author, Watchers and Subscribers. | -| Merge Request | Milestone changed | Subscribers and participants. | -| Merge Request | Milestone removed | Subscribers and participants. | -| Merge Request | New | Anyone mentioned by username in the description, with notification level "Mention" or higher. | -| Merge Request | New note | Participants, Watchers, Subscribers, and Custom notification level with this event selected. Also anyone mentioned by username in the comment, with notification level "Mention" or higher. | -| Merge Request | Pushed | Participants and Custom notification level with this event selected. | -| Merge Request | Reassigned | Participants, Watchers, Subscribers, Custom notification level with this event selected, and the old assignee. | -| Merge Request | Review requested | Participants, Watchers, Subscribers, Custom notification level with this event selected, and the old reviewer. | -| Merge Request | Reopened | Subscribers and participants. | -| Merge Request | Title or description changed | Any new mentions by username. | -| Merge Request | Merge request you're [eligible to approve](../project/merge_requests/approvals/rules.md#eligible-approvers) is created | Custom notification level with this event selected. [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/12855) in GitLab 16.7. [Renamed](https://gitlab.com/gitlab-org/gitlab/-/issues/465347) from "Added as approver" in GitLab 17.11. | -| Pipeline | Failed | The author of the pipeline. | -| Pipeline | Fixed | The author of the pipeline. Enabled by default. | -| Pipeline | Successful | The author of the pipeline, with Custom notification level for successful pipelines. If the pipeline failed previously, a "Fixed pipeline" message is sent for the first successful pipeline after the failure, and then a "Successful pipeline" message for any further successful pipelines. | -| Pipeline by service account | Failed | Custom notification level for failed pipelines triggered by service accounts. | -| Pipeline by service account | Fixed | Custom notification level for fixed pipelines triggered by service accounts. | -| Pipeline by service account | Successful | Custom notification level for successful pipelines triggered by service accounts. | - -By default, you don't receive notifications for issues, merge requests, or epics created by yourself. -To always receive notifications on your own issues, merge requests, and so on, turn on +| Issue | Reassigned | Participants, watchers, subscribers, custom notification level with **Issue is reassigned** selected, and the previous assignee. | +| Issue | Reopened | Subscribers, participants, and custom notification level with **Issue is reopened** selected. | +| Merge request | Closed | Subscribers, participants, and custom notification level with **Merge request is closed** selected. | +| Merge request | Conflict | Author and any user that has set the merge request to auto-merge. | +| Merge request | [Marked as ready](../project/merge_requests/drafts.md) | Watchers and participants. | +| Merge request | Merged | Subscribers, participants, and custom notification level with **Merge request is merged** selected. | +| Merge request | Merged when pipeline succeeds | Author, participants, watchers, subscribers, and custom notification level with **Merge request is set to auto-merge** selected. Custom notification level is ignored for author, watcher, and subscribers. | +| Merge request | Milestone changed | Subscribers and participants. | +| Merge request | Milestone removed | Subscribers and participants. | +| Merge request | New | Anyone mentioned by username in the description, with notification level **Mention** or higher. Custom notification level with **Merge request is created** selected. | +| Merge request | New comment | Participants, watchers, subscribers, and custom notification level with **Comment is added** selected. Anyone mentioned by username in the comment, with notification level **Mention** or higher. | +| Merge request | Pushed | Participants and custom notification level with **Merge request receives a push** selected. | +| Merge request | Reassigned | Participants, watchers, subscribers, custom notification level with **Merge request is reassigned** selected, and the previous assignee. | +| Merge request | Review requested | Participants, watchers, subscribers, custom notification level with **Merge request reviewers are changed** selected, and the previous reviewer. | +| Merge request | Reopened | Subscribers, participants, and custom notification level with **Merge request is reopened** selected. | +| Merge request | Title or description changed | Any new mentions by username. | +| Merge request | New merge request you're [eligible to approve](../project/merge_requests/approvals/rules.md#eligible-approvers). | Custom notification level with **Merge request you're eligible to approve is created** selected. | +| Pipeline | Failed | The author of the pipeline and custom notification level with **Pipeline fails** selected. | +| Pipeline | Fixed | The author of the pipeline (enabled by default). Custom notification level with **Pipeline is fixed** selected.| +| Pipeline | Successful | The author of the pipeline. Custom notification level with **Pipeline is successful** selected. If the pipeline failed previously, a "Fixed pipeline" message is sent for the first successful pipeline after the failure, and then a "Successful pipeline" message for any further successful pipelines. | +| Pipeline by service account | Failed | Custom notification level with **Pipeline by Service Account fails** selected. | +| Pipeline by service account | Fixed | Custom notification level with **Pipeline by Service Account is fixed** selected. | +| Pipeline by service account | Successful | Custom notification level with **Pipeline by Service Account is successful** selected. | + +By default, you don't receive notifications for issues, merge requests, or epics you create. +You can turn on [notifications about your own activity](#global-notification-settings). ## Notifications for unknown sign-ins