Every Email Service Provider (ESP) handles unsubscribes differently. Sendwithus hooks into your ESP’s unsubscribe system, which means you will use whatever your ESP requires.

We are working towards a unified experience for all our customers, but for now, this is how you add unsubscribe links to your emails with SendGrid, Mailgun, or Mandrill.


SendGrid manages unsubscribes at the account/subuser level, which means customers who unsubscribe from an email will not receive any other emails sent from that SendGrid account.

To use SendGrid unsubscribes, enable the Subscription Tracking App in your SendGrid account. To learn how, visit their Subscription Tracking App support page.

Once you’ve enabled the app, it will automatically add a default unsubscribe link to the bottom of your emails.

If you decide to use a custom “replacement tag” (as defined in the Subscription Tracking App support page), we recommend using a replacement tag that looks like %sendgrid_unsub_url%, as we know that format will render properly in our templates.

The replacement tag settings can be found under Settings->Tracking->Subscription Tracking. Check out the image below for an example:

Replacement Tag Example

This is what your unsubscribe link might look like with the replacement tag:

<a href="%sendgrid_unsub_url%">Click to unsubscribe.</a>

Sendwithus does not support SendGrid subscription groups. We recommend using multiple Sendgrid subusers to manage these groups.


Enable Mailgun unsubscribes by clicking the checkbox in the Unsubscribes tab of your Mailgun Control Panel. This will automatically append the default unsubscribe link to the bottom of your emails.

You can learn more about Mailgun’s unsubscribe features in their Tracking Unsubscribes support article.

Mailgun supports three types of unsubscribes:

  1. Domain: if unsubscribed, a user would no longer get emails from that Mailgun account.
  2. Tag: if unsubscribed, a user would no longer get emails associated with that specific tag.
  3. Mailing List: if unsubscribed, a user would get no further emails addressed to that mailing list.

These are the same tags that you create in the Templates section in your Sendwithus Dashboard. Learn how here.

They provide a variable for each type of unsubscribe, and to use this feature you just need to include the appropriate variable in your email template:

  • Domain: %unsubscribe_url%
  • Tag: %tag_unsubscribe_url%
  • Mailing List: %mailing_list_unsubscribe_url% For example, an unsubscribe link in an email template would look like this:
<a href="%unsubscribe_url%">Click to unsubscribe.</a>


Mandrill uses an “unsubscribe merge tag” that you include in your unsubscribe link. Unsubscribed users are added to a “Rejection” Blocklist.

“The merge tag consists of the word UNSUB, followed by a colon, and then a full website address (with http:// or https://) where recipients should be redirected when the unsubscribe is processed.” This description is from their support article, where you can go to learn more.

This is an example of an unsubscribe merge tag: *|UNSUB:http://mywebsite.com/unsub|*

This is what your unsubscribe link might look like with the unsubscribe merge tag:

<a href="*|UNSUB:http://mywebsite.com/unsub|*">Click to unsubscribe.</a>