More headers in emails to describe changes

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

  • Close this issue

Description

Currently GitLab emails have very basic headers which can be used to sort/filter mails. There is X-GitLab-{Project,Project-Id,Project-Path,Author,MergeRequest-ID,Issue-ID} which are good starts to filtering various projects but it would be ideal if we could also filter various state changes like when a branch is merged, added, etc.

Proposal

Add a few more headers on when certain things happened. A very simple one might be something like:

X-GitLab-Reason: {branch_deleted,push,branch_created,request_merged}

The main reason for this is I get one-line emails on when a topic branch is created or deleted and it drives me nuts. I'd love to just delete those out of hand because I don't care and I'm drowning in email anyways. So if I could filter on that, it would be amazing.

I'm sure there are other things that could be done as well, especially for GitLab issues mails. Some quick thoughts:

X-GitLab-Type: changed
X-GitLab-Issue-ID: 1234
X-GitLab-Issue-Reason: state
X-GitLab-Issue-State: In Progress

The above clearly tells you that issue 1234 had it's state changed to "In Progress" which would be great for filtering on.

Links / references

I'm a heavy bugzilla user, and the below are some of the things that bugzilla sends in its mails which are really helpful for filtering:

X-Bugzilla-Reason: CC
X-Bugzilla-Type: changed
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Classification: JBoss
X-Bugzilla-Product: JBoss Enterprise Application Platform 6
X-Bugzilla-Component: distribution
X-Bugzilla-Sub-Component: 
X-Bugzilla-Version: 6.4.14
X-Bugzilla-Keywords: Rebase
X-Bugzilla-Severity: low
X-Bugzilla-Who: ichangedthis@somewhere.com
X-Bugzilla-Status: ON_QA
X-Bugzilla-Priority: unspecified
X-Bugzilla-Assigned-To: someone@somewhere.com
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Changed-Fields: cc
X-Bugzilla-Comment: none
X-Bugzilla-Reporter: someone@somewhere.com
Edited Jun 14, 2025 by 🤖 GitLab Bot 🤖
Assignee Loading
Time tracking Loading