ability to add custom email headers

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

  • Close this issue

Problem to solve

Customer statement in internal zendesk link:

We use AWS SES for sending email from our GitLab instance. We recently ran into an issue where a user's email address was set improperly which resulted in many bounced emails. This affected our SES Reputation and could have resulted in us losing the ability to send email. While SES doesn't provide much visibility into bounced emails themselves, it can send bounced emails to an SNS Topic or Kinesis Stream through the use of Configuration Sets (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/monitor-using-event-publishing.html) . We'd like to use this to help troubleshoot and catch these bounced emails earlier in the future, but in order to use them the sender needs to add an X-SES-CONFIGURATION-SET header to emails (https://docs.aws.amazon.com/ses/latest/DeveloperGuide/event-publishing-send-email.html#event-publishing-using-custom-headers) .

Proposal

Give the GitLab administrator the ability to add custom headers in the smtp configuration for the site.

Permissions and Security

Only site administrator should have access to change this.

Documentation

Document how to add custom smtp headers.

Edited Aug 28, 2025 by 🤖 GitLab Bot 🤖
Assignee Loading
Time tracking Loading