diff options
Diffstat (limited to 'doc/user/profile/notifications.md')
| -rw-r--r-- | doc/user/profile/notifications.md | 62 |
1 files changed, 33 insertions, 29 deletions
diff --git a/doc/user/profile/notifications.md b/doc/user/profile/notifications.md index 4c9622810b2..d0e9b427f1c 100644 --- a/doc/user/profile/notifications.md +++ b/doc/user/profile/notifications.md @@ -11,7 +11,7 @@ Stay informed about what's happening in GitLab with email notifications. You can receive updates about activity in issues, merge requests, epics, and designs. For the tool that GitLab administrators can use to send messages to users, read -[Email from GitLab](../../tools/email.md). +[Email from GitLab](../admin_area/email_from_gitlab.md). ## Who receives notifications @@ -21,11 +21,14 @@ that happen there. You might receive notifications for one of the following reasons: - You participate in an issue, merge request, epic, or design. You become a participant when you comment - or edit, or someone mentions you. + or edit, or someone mentions <sup>1</sup> you. - You've [enabled notifications in an issue, merge request, or epic](#notifications-on-issues-merge-requests-and-epics). - You've configured notifications for the [project](#change-level-of-project-notifications) or [group](#group-notifications). - You're subscribed to group or project pipeline notifications via the pipeline emails [integration](../project/integrations/overview.md). +1. GitLab doesn't send a notification when + [a comment is edited to include a user mention](../discussions/index.md#editing-a-comment-to-add-a-mention). + NOTE: Administrators can block notifications, preventing them from being sent. @@ -171,26 +174,27 @@ Users are notified of the following events: <!-- The table is sorted first by recipient, then alphabetically. --> -| Event | Sent to | Settings level | -|------------------------------|---------------------|------------------------------| -| New release | Project members | Custom notification. | -| Project moved | Project members | Any other than disabled. | -| Email changed | User | Security email, always sent. | -| Group access level changed | User | Sent when user group access level is changed. | -| New email added | User | Security email, always sent. | -| New SAML/SCIM user provisioned | User | Sent when a user is provisioned through SAML/SCIM. [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/276018) in GitLab 13.8 | -| New SSH key added | User | Security email, always sent. | -| New user created | User | Sent on user creation, except for OmniAuth (LDAP). | -| Password changed | User | Security email, always sent when user changes their own password. | -| Password changed by administrator | User | Security email, always sent when an administrator changes the password of another user. | -| Personal access tokens expiring soon | User | Security email, always sent. | -| Personal access tokens have been created | User | Security email, always sent. [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/337591) in GitLab 14.9. | -| Personal access tokens have expired | User | Security email, always sent. | -| Project access level changed | User | Sent when user project access level is changed. | -| SSH key has expired | User | Security email, always sent. _[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/322637) in GitLab 13.12._ | -| Two-factor authentication disabled | User | Security email, always sent. | -| User added to group | User | Sent when user is added to group. | -| User added to project | User | Sent when user is added to project. | +| Event | Sent to | Settings level | +|------------------------------------------|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------| +| New release | Project members | Custom notification. | +| Project moved | Project members | Any other than disabled. | +| 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. _[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/337635) in GitLab 14.9._ | +| New email address added | User | Security email, sent to newly-added email address. | +| New SAML/SCIM user provisioned | User | Sent when a user is provisioned through SAML/SCIM. _[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/276018) in GitLab 13.8._ | +| New SSH key added | User | Security email, always sent. | +| New user created | User | Sent on user creation, except for OmniAuth (LDAP). | +| Password changed | User | Security email, always sent when user changes their own password. | +| Password changed by administrator | User | Security email, always sent when an administrator changes the password of another user. | +| Personal access tokens expiring soon | User | Security email, always sent. | +| Personal access tokens have been created | User | Security email, always sent. _[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/337591) in GitLab 14.9._ | +| Personal access tokens have expired | User | Security email, always sent. | +| Project access level changed | User | Sent when user project access level is changed. | +| SSH key has expired | User | Security email, always sent. _[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/322637) in GitLab 13.12._ | +| Two-factor authentication disabled | User | Security email, always sent. | +| User added to group | User | Sent when user is added to group. | +| User added to project | User | Sent when user is added to project. | ## Notifications on issues, merge requests, and epics @@ -241,26 +245,26 @@ epics: | Event | Sent to | |------------------------|---------| -| Change milestone issue | Subscribers, participants mentioned, and Custom notification level with this event selected. | -| Change milestone merge request | Subscribers, participants mentioned, and Custom notification level with this event selected. | +| Change milestone issue | Subscribers and participants mentioned. | +| Change milestone merge request | Subscribers and participants mentioned. | | Close epic | | | Close issue | | | Close merge request | | -| Due issue | Participants and Custom notification level with this event selected. | | Failed pipeline | The author of the pipeline. | | Fixed pipeline | The author of the pipeline. Enabled by default. _[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/24309) in GitLab 13.1._ | +| Issue due | Participants and Custom notification level with this event selected. | | Merge merge request | | | Merge 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. _[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/211961) in GitLab 13.4._ | | Merge request [marked as ready](../project/merge_requests/drafts.md) | Watchers and participants. _[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/15332) in GitLab 13.10._ | -| New comment | 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. | | New epic | | | New issue | | | New 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. | | Push to merge request | Participants and Custom notification level with this event selected. | | Reassign issue | Participants, Watchers, Subscribers, Custom notification level with this event selected, and the old assignee. | | Reassign merge request | Participants, Watchers, Subscribers, Custom notification level with this event selected, and the old assignee. | -| Remove milestone issue | Subscribers, participants mentioned, and Custom notification level with this event selected. | -| Remove milestone merge request | Subscribers, participants mentioned, and Custom notification level with this event selected. | +| Remove milestone issue | Subscribers and participants mentioned. | +| Remove milestone merge request | Subscribers and participants mentioned. | | Reopen epic | | | Reopen issue | | | Reopen merge request | | @@ -304,7 +308,7 @@ If you no longer wish to receive any email notifications: **Disabled**. On self-managed installations, even after doing this, your instance administrator -[can still email you](../../tools/email.md). +[can still email you](../admin_area/email_from_gitlab.md). To unsubscribe, select the unsubscribe link in one of these emails. ## Email headers you can use to filter email |