Skip to main content
When users unsubscribe to your marketing emails, MoEngage ensures that no further emails are sent to them. You can manage these unsubscribes in multiple different ways. This provides you with the highest amount of control over the handling of the unsubscribe link.

​
MoEngage Tracking

If you select MoEngage tracking, MoEngage will add the unsubscribe link in the non-transactional email. Follow the below steps to add the unsubscribe URL:
  1. In the MoEngage dashboard, go to Settings > Channels > Email.
  2. In the following Email Settings page that appears, click Sender Configuration tab
  3. Click Add Sender, and go to the Unsubscribe Settings section.
  4. Select MoEngage Tracking. Ensure that other email service provider connectors such as Sendgrid, Mandrill, Sparkpost, or custom connector have turned off unsubscribe tracking. Otherwise, there will be two unsubscribe links in the same email.
  5. In the Unsubscribe Page URL field, enter the required URL. MoEngage provides a standard landing page.
  6. You can add the unsubscribe URL shown below to the Unsubscribe Page URL field. In this case, the user automatically gets unsubscribed. 
    https://api-0X.moengage.com/v1/emailresubscribe
    “X” here denotes your data center.
  7. They have the option to resubscribe by clicking on the resubscribe mebutton on the landing page. You can also create a landing page of your own and add the URL for the same. This gives you more autonomy over the process and allows you to do things like capturing the reason why the user wants to unsubscribe.
  8. You can also choose to place the unsubscribe link anywhere in the email body by using the below HTML code:
    HTML
     <a href="https://api-0X.moengage.com/v1/emailresubscribe" data-msys-unsubscribe="“1”"> unsubscribe_text </a>
Each customer is hosted on a different data center. You can find your data center number (value of “X” in the Unsubscribe page URL) by checking the data center and API endpoint mapping page here.Also, while custom positioning, please make sure the link within the href has HTTPS or HTTP protocol mentioned for the same to work in the correct manner.

​
Configure a Replacement Tag for MoEngage Tracking

You can use replacement tags and codes to include the unsubscribe link in emails and customize the text for the unsubscribe link.
  • If you want to customize your landing page, you can add your own page URL.
  • To include the unsubscribe link in your custom landing page, add the following HTML code in the HTML template of your email body:
    HTML
     <a data-msys-unsubscribe=“1” href="https://custom.landingpage.com/default_moengage_unsubscribe_flow"> Click here to Unsubscribe </a>
    MoE tracking 2.png You can also add the HTML code in the WYSIWYG editor. You can customize the code to align with your email template as shown in the below example.
    HTML
    <span style="font-size: 14px;">Want to change how you receive these emails?</span><span style="font-size: 14px;">You can</span> <a data-msys-unsubscribe=""1"" href="https://custom.landingpage.com/default_moengage_unsubscribe_flow" style="font-size: 14px;mso-line-height-rule: exactly;-ms-text-size-adjust: 100%;-webkit-text-size-adjust: 100%;color: #656565;font-weight: normal;text-decoration: underline;"> unsubscribe from this list. </a>
    which results in the following output: TEU 3.png
While custom positioning, please make sure the link within the href has HTTPS or HTTP protocol mentioned for the same to work in the correct manner.

​
Email Service Provider Tracking

If you are using SendGrid, Mandrill, or SparkPost for unsubscribe tracking, you can go to their documentation to understand how to set this up. If you choose this option, your email service provider will include an unsubscribe link in the body of the email and not MoEngage.
  • You will also need to update MoEngage’s callback URL on the email service provider’s dashboard. To access the URL, In the MoEngage dashboard, go to Settings > Under Channels, Emails> Sender Configuration tab>Add Sender>Bounce&Compliant Tracking.
If a user clicks on the unsubscribe link, the service provider will manage the request. Pass this data back to MoEngage using the Data API to update the corresponding user profile in the MoEngage dashboard.

​
SendGrid

If you choose SendGrid tracking for unsubscribe management, make sure that you make the corresponding change in the subscription tracking in SendGrid. If subscription tracking is enabled in SendGrid, it will insert a one-click unsubscribe link in the emails.
  • If you want to add the unsubscribe link within the email body, make use of the replacement text: [unsubscribe_here]. This text is case-sensitive. This is only relevant to the MoEngage-managed SendGrid customers. Other customers can add their own replacement text. [unsubscribe_here] will not be added by default.
If the webhooks are correctly configured then SendGrid will pass the unsubscribe data back to MoEngage in near real-time and the user reachability will be accordingly updated.

​
Configure a Replacement Tag for Sendgrid Tracking

You can use replacement tags and codes to include the unsubscribe link in emails and customize the text for the unsubscribe link.
  1. Go to Sendgrid > Settings > Tracking > Suppression Tracking.
  2. Add your preferred replacement tag.
    • MoEngage uses the tag “[unsubscribe_here]” because it is unlikely to be used by mistake in the email body.
    • The replacement tag is case-sensitive. TEU 1.png
  3. If you place this tag as the link value anywhere in the email body, it will act as the Unsubscribe link.
    For example:
    In HTML Editor TEU 2.pngIn Drag and Drop Editor MoE tracking.png

​
Mandrill

If you choose Mandrill tracking for unsubscribe management on the MoEngage dashboard, then ensure that you make the corresponding change in the subscription tracking section of Mandrill.
  • If you enable subscription tracking in Mandrill, they will insert an unsubscribe link in the emails.
If the webhooks are correctly configured then Mandrill will pass the unsubscribe data back to MoEngage in near real-time and the user reachability will be accordingly updated.

​
SparkPost

If you choose SparkPost tracking for unsubscribe management on the MoEngage dashboard, then ensure that you make the corresponding change in the subscription tracking section of SparkPost.
  • If you enable subscription tracking in SparkPost, they will insert an unsubscribe link in the emails.
If the webhooks are correctly configured then SparkPost will pass the unsubscribe data back to MoEngage in near real-time and the user reachability will be accordingly updated.

​
None

If you select the unsubscribe option as None then MoEngage expects you to manage this process from your end to remain compliant. You need to ensure that subscription tracking or unsubscribe settings are disabled on the connected email service provider. Include your own unsubscribe URL in the email template. This will not get tracked under the unsubscribe event and you have to capture and manage the unsubscribe requests from your end. Pass this data back to MoEngage using the Data API to update the corresponding user profile in the MoEngage dashboard.

​
Preference Management

If you wish to provide an option to categorically subscribe to certain kinds of email communications or select the frequency of email communications, use the subscription categories offered by MoEngage. It is still recommended to configure the option to unsubscribe from all emails at the end of the preference management page.