SimpleMH Unsubscribe Links
An unsubscribe link gets inserted by GreenArrow Engine if the following conditions occur:
- SimpleMH is being used
- The Mail Class that a message belongs to has unsubscribe link processing turned on.
- The
##unsubscribetag##string is included in the message, followed by the URL that unsubscribe link clicks should be redirected to.
Here’s an HTML example:
<a href="##unsubscribetag##http://www.example.com/">Unsubscribe</a>
Here’s a text example:
##unsubscribetag##http://www.example.com/
When an unsubscribe link is clicked, it’s logged by the Event Notification System as an engine_unsub event, and the visitor is redirected to the URL that follows the ##unsubscribetag## string.
GreenArrow passes recipient information to your URL by appending query string parameters, including the recipient’s email address and the message’s SendID and ListID.
For example, given the following URL template and recipient data:
| Description | Value |
|---|---|
| URL | ##unsubscribetag##http://www.example.com/ |
| Recipient Email | [email protected] |
| SendID | default20250101 |
| ListID | example1 |
After recording the unsubscribe, the visitor would be redirected to:
http://www.example.com/?email=user%40example.com&sendid=default20250101&listid=example1
If you use this functionality, please be sure that you’re performing timely processing of events that are logged by the Event Notification System, so that unsubscribes are honored.
Clicks on SimpleMH unsubscribe links are eligible for Bad Address Suppression.