Skip to content

GitLab

Email from GitLab (STARTER ONLY)

GitLab provides a simple tool to administrators for emailing all users, or users of a chosen group or project, right from the Admin Area. Users will receive the email at their primary email address.

Use-cases

  • Notify your users about a new project, a new feature, or a new product launch.
  • Notify your users about a new deployment, or that will be downtime expected for a particular reason.

Sending emails to users from within GitLab

  1. Navigate to the Admin Area > Overview > Users and press the Send email to users button.

    admin users

  2. Compose an email and choose where it will be sent (all users or users of a chosen group or project). The email body only supports plain text messages. HTML, Markdown, and other rich text formats are not supported, and will be sent as plain text to users.

    compose an email

NOTE: Note: Starting with GitLab 13.0, email notifications can be sent only once every 10 minutes. This helps minimize performance issues.

Unsubscribing from emails

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.

On unsubscribe, users will receive an email notification that unsubscribe happened. The endpoint that provides the unsubscribe option is rate-limited.