119 lines
5.2 KiB
Markdown
119 lines
5.2 KiB
Markdown
---
|
|
type: reference
|
|
stage: Plan
|
|
group: Project Management
|
|
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
|
|
---
|
|
|
|
# Email **(FREE SELF)**
|
|
|
|
You can customize some of the content in emails sent from your GitLab instance.
|
|
|
|
## Custom logo
|
|
|
|
The logo in the header of some emails can be customized, see the [logo customization section](../appearance.md#top-bar).
|
|
|
|
## Include author name in email notification email body **(PREMIUM SELF)**
|
|
|
|
By default, GitLab overrides the email address in notification emails with the email address
|
|
of the issue, merge request, or comment author. Enable this setting to include the author's email
|
|
address in the body of the email instead.
|
|
|
|
To include the author's email address in the email body:
|
|
|
|
1. On the top bar, select **Main menu > Admin**.
|
|
1. On the left sidebar, select **Settings > Preferences** (`/admin/application_settings/preferences`).
|
|
1. Expand **Email**.
|
|
1. Select the **Include author name in email notification email body** checkbox.
|
|
1. Select **Save changes**.
|
|
|
|
## Enable multipart email **(PREMIUM SELF)**
|
|
|
|
GitLab can send email in multipart format (HTML and plain text) or plain text only.
|
|
|
|
To enable multipart email:
|
|
|
|
1. On the top bar, select **Main menu > Admin**.
|
|
1. On the left sidebar, select **Settings > Preferences** (`/admin/application_settings/preferences`).
|
|
1. Expand **Email**.
|
|
1. Select **Enable multipart email**.
|
|
1. Select **Save changes**.
|
|
|
|
## Custom hostname for private commit emails **(PREMIUM SELF)**
|
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/22560) in GitLab 11.5.
|
|
|
|
This configuration option sets the email hostname for [private commit emails](../../profile/index.md#use-an-automatically-generated-private-commit-email).
|
|
By default it is set to `users.noreply.YOUR_CONFIGURED_HOSTNAME`.
|
|
|
|
To change the hostname used in private commit emails:
|
|
|
|
1. On the top bar, select **Main menu > Admin**.
|
|
1. On the left sidebar, select **Settings > Preferences** (`/admin/application_settings/preferences`).
|
|
1. Expand **Email**.
|
|
1. Enter the desired hostname in the **Custom hostname (for private commit emails)** field.
|
|
1. Select **Save changes**.
|
|
|
|
NOTE:
|
|
After the hostname is configured, every private commit email using the previous hostname is not
|
|
recognized by GitLab. This can directly conflict with certain [Push rules](../../project/repository/push_rules.md) such as
|
|
`Check whether author is a GitLab user` and `Check whether committer is the current authenticated user`.
|
|
|
|
## Custom additional text **(PREMIUM SELF)**
|
|
|
|
You can add additional text at the bottom of any email that GitLab sends. This additional text
|
|
can be used for legal, auditing, or compliance reasons, for example.
|
|
|
|
To add additional text to emails:
|
|
|
|
1. On the top bar, select **Main menu > Admin**.
|
|
1. On the left sidebar, select **Settings > Preferences** (`/admin/application_settings/preferences`).
|
|
1. Expand **Email**.
|
|
1. Enter your text in the **Additional text** field.
|
|
1. Select **Save changes**.
|
|
|
|
## User deactivation emails
|
|
|
|
GitLab sends email notifications to users when their account has been deactivated.
|
|
|
|
To disable these notifications:
|
|
|
|
1. On the top bar, select **Main menu > Admin**.
|
|
1. On the left sidebar, select **Settings > Preferences** (`/admin/application_settings/preferences`).
|
|
1. Expand **Email**.
|
|
1. Clear the **Enable user deactivation emails** checkbox.
|
|
1. Select **Save changes**.
|
|
|
|
### Custom additional text in deactivation emails **(FREE SELF)**
|
|
|
|
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/355964) in GitLab 15.9 [with a flag](../../../administration/feature_flags.md) named `deactivation_email_additional_text`. Disabled by default.
|
|
> - [Enabled on self-managed and GitLab.com](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/111882) in GitLab 15.9.
|
|
|
|
FLAG:
|
|
On self-managed GitLab, by default this feature is available. To hide the feature, ask an
|
|
administrator to [disable the feature flag](../../../administration/feature_flags.md) named
|
|
`deactivation_email_additional_text`.
|
|
|
|
You can add additional text at the bottom of the email that GitLab sends to users when their account
|
|
is deactivated. This email text is separate from the [custom additional text](#custom-additional-text)
|
|
setting.
|
|
|
|
To add additional text to deactivation emails:
|
|
|
|
1. On the top bar, select **Main menu > Admin**.
|
|
1. On the left sidebar, select **Settings > Preferences** (`/admin/application_settings/preferences`).
|
|
1. Expand **Email**.
|
|
1. Enter your text in the **Additional text for deactivation email** field.
|
|
1. Select **Save changes**.
|
|
|
|
<!-- ## 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, for example `### 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. -->
|