List-Unsubscribe Email

Sending emails to users who are not interested does not bring in any value. Moreover, indifferent users tend to mark emails as spam if they can't easily opt out of receiving them. This indicates to email servers such as Gmail or Yahoo that your emails are unwanted, which could harm your brand reputation and affect the deliverability of other emails.

List-Unsubscribe provides a simpler way to opt out of emails, reducing the chance of marking them as spam.

Including a clear unsubscribe link in the header also shows confidence in the quality of your messaging. Starting in February 2024, email marketers sending emails to Gmail or Yahoo! subscribers must follow their new deliverability policies that include the use of List-Unsubscribe headers.

How does a List-Unsubscribe Header work?

You can configure the Unsubscribe management by logging into your MoEngage dashboard and navigating to the Settings module > Channels > Email settings > choosing the Email connector from the left pane in the CONNECTOR CONFIG section > viewing Unsubscribe Settings.



Reach out to your Customer Success Manager (CSM) to enable unsubscribe management.

MoEngage provides three methods to configure a List-Unsubscribe header:

  • MoEngage Tracking
  • Sendgrid Tracking
  • None

MoEngage Tracking

In case the MoEngage Tracking option is selected on your dashboard, MoEngage will take responsibility for setting up and managing the List-Unsubscribe process for you.

This means that MoEngage inserts a List-Unsubscribe header in all non-transactional email communications.

In case any recipient requests an unsubscribe using the List-Unsubscribe feature, the corresponding email lands in the MoEngage-monitored inbox. MoEngage then parses through the email and updates the reachability of the relevant user.

moengage email unsubscribe.png

Sendgrid Tracking

MoEngage will use unsubscribe information received on the Callback URL from Sendgrid to track unsubscribes. You can find the callback URL by going to Settings > Channels > Email > Sender Configuration > Unsubscribe Settings.

sendgrid email unsubscribe.png

For more information on how Sendgrid Tracking works, see List-Unsubscribe.


If you don’t want to use MoEngage’s unsubscribe feature, we have made provisions for you to be compliant.

You can use the None option in the Unsubscribe Settings. This process requires that you provide MoEngage with a dedicated email address to which unsubscribe requests are sent. For example, 

MoEngage will then embed the correct syntax and email address into the header of your emails.

Ensure to monitor the inbox dedicated to unsubscribes and manually remove email addresses from your mailing list when unsubscribe requests arrive. Furthermore, you need to update reachability within 48 hours of a List-Unsubscribe request and ensure you forward it to MoEngage.

You can configure this by going to Settings > Email > Sender Configuration > Unsubscribe Settings and adding a mailbox of your own. 




You can set auto-forward emails to one of MoEngage's monitored mailboxes if you don't want to handle all of the logic yourself. In this scenario, when a client requests to unsubscribe, they will see your email address, but you will be able to make use of MoEngage's setup without having to do any more work on your end.

Refer to the relevant documents below for setting up auto-forwarding in different ESPS:



Was this article helpful?
0 out of 0 found this helpful

How can we improve this article?