2019-09-04 21:01:54 +05:30
---
type: reference
2020-06-23 00:09:42 +05:30
stage: Plan
group: Project Management
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
---
2021-03-11 19:13:27 +05:30
# Email **(FREE SELF)**
2018-05-09 12:01:36 +05:30
2019-09-04 21:01:54 +05:30
You can customize some of the content in emails sent from your GitLab instance.
2018-05-09 12:01:36 +05:30
## Custom logo
2019-12-26 22:10:19 +05:30
The logo in the header of some emails can be customized, see the [logo customization section ](../appearance.md#navigation-bar ).
2018-12-13 13:39:08 +05:30
2021-03-11 19:13:27 +05:30
## Custom additional text **(PREMIUM SELF)**
2019-07-31 22:56:46 +05:30
2020-05-24 23:13:21 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/5031) in [GitLab Premium](https://about.gitlab.com/pricing/) 10.7.
2019-07-31 22:56:46 +05:30
2021-02-22 17:27:13 +05:30
The additional text appears at the bottom of any email and can be used for
2019-07-31 22:56:46 +05:30
legal/auditing/compliance reasons.
2021-09-04 01:27:46 +05:30
1. On the top bar, select **Menu >** ** {admin}** **Admin** .
1. On the left sidebar, select **Settings > Preferences** (`/admin/application_settings/preferences`).
1. Expand **Email** .
2019-10-12 21:52:04 +05:30
1. Enter your text in the **Additional text** field.
1. Click **Save** .
2019-07-31 22:56:46 +05:30
2018-12-13 13:39:08 +05:30
## Custom hostname for private commit emails
2020-03-13 15:44:24 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/22560) in GitLab 11.5.
2018-12-13 13:39:08 +05:30
2021-04-17 20:07:23 +05:30
This configuration option sets the email hostname for [private commit emails ](../../profile/index.md#use-an-automatically-generated-private-commit-email ).
2019-09-04 21:01:54 +05:30
By default it is set to `users.noreply.YOUR_CONFIGURED_HOSTNAME` .
2018-12-13 13:39:08 +05:30
In order to change this option:
2021-09-04 01:27:46 +05:30
1. On the top bar, select **Menu >** ** {admin}** **Admin** .
1. On the left sidebar, select **Settings > Preferences** (`/admin/application_settings/preferences`).
1. Expand **Email** .
2021-02-22 17:27:13 +05:30
1. Enter the desired hostname in the **Custom hostname (for private commit emails)** field.
1. Select **Save changes** .
2018-12-13 13:39:08 +05:30
2021-02-22 17:27:13 +05:30
NOTE:
2021-03-11 19:13:27 +05:30
After the hostname gets configured, every private commit email using the previous hostname is not
2019-09-04 21:01:54 +05:30
recognized by GitLab. This can directly conflict with certain [Push rules ](../../../push_rules/push_rules.md ) such as
2018-12-13 13:39:08 +05:30
`Check whether author is a GitLab user` and `Check whether committer is the current authenticated user` .
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
2019-10-12 21:52:04 +05:30
but commented out to help encourage others to add to it in the future. -->
