2019-09-04 21:01:54 +05:30
---
2021-01-29 00:20:46 +05:30
stage: none
group: unassigned
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2019-09-04 21:01:54 +05:30
type: howto, reference
---
2019-07-31 22:56:46 +05:30
2021-09-04 01:27:46 +05:30
# Email from GitLab **(PREMIUM SELF)**
2019-07-31 22:56:46 +05:30
2021-09-04 01:27:46 +05:30
GitLab provides a tool to administrators for emailing all users, or users of
2021-02-22 17:27:13 +05:30
a chosen group or project, right from the Admin Area. Users receive the email
2019-09-04 21:01:54 +05:30
at their primary email address.
2019-07-31 22:56:46 +05:30
2021-04-29 21:17:54 +05:30
For information about email notifications originating from GitLab, read
[GitLab notification emails ](../user/profile/notifications.md ).
2019-07-31 22:56:46 +05:30
## Use-cases
- Notify your users about a new project, a new feature, or a new product launch.
2021-02-22 17:27:13 +05:30
- Notify your users about a new deployment, or that downtime is expected
2019-07-31 22:56:46 +05:30
for a particular reason.
## Sending emails to users from within GitLab
2021-11-11 11:23:49 +05:30
1. On the top bar, select **Menu > Admin** .
1. On the left sidebar, select **Overview > Users** .
2021-09-04 01:27:46 +05:30
1. Select **Send email to users** .
2019-07-31 22:56:46 +05:30
2019-10-12 21:52:04 +05:30
2019-07-31 22:56:46 +05:30
2021-02-22 17:27:13 +05:30
1. Compose an email and choose where to send it (all users or users of a
2020-07-28 23:09:34 +05:30
chosen group or project). The email body only supports plain text messages.
2021-02-22 17:27:13 +05:30
HTML, Markdown, and other rich text formats are not supported, and is
2020-07-28 23:09:34 +05:30
sent as plain text to users.
2019-07-31 22:56:46 +05:30
2019-10-12 21:52:04 +05:30
2019-07-31 22:56:46 +05:30
2021-02-22 17:27:13 +05:30
NOTE:
2020-05-24 23:13:21 +05:30
[Starting with GitLab 13.0 ](https://gitlab.com/gitlab-org/gitlab/-/issues/31509 ), email notifications can be sent only once every 10 minutes. This helps minimize performance issues.
2019-07-31 22:56:46 +05:30
## Unsubscribing from emails
2019-09-04 21:01:54 +05:30
Users can choose to unsubscribe from receiving emails from GitLab by following
the unsubscribe link in the email. Unsubscribing is unauthenticated in order
to keep this feature simple.
2019-07-31 22:56:46 +05:30
2021-02-22 17:27:13 +05:30
On unsubscribe, users receive an email notification that unsubscribe happened.
2019-07-31 22:56:46 +05:30
The endpoint that provides the unsubscribe option is rate-limited.
2019-09-04 21:01:54 +05:30
<!-- ## Troubleshooting
Include any troubleshooting steps that you can foresee. If you know beforehand what issues
one might have when setting this up, or when something is changed, or on upgrading, it's
important to describe those, too. Think of things that may go wrong and include them here.
This is important to minimize requests for support, and to avoid doc comments with
questions that you know someone might ask.
Each scenario can be a third-level heading, e.g. `### Getting error message X` .
If you have none to add when creating a doc, leave this section in place
but commented out to help encourage others to add to it in the future. -->
