Unsubscribe Links in Email

Email Unsubscribe Link

OptiPub's Unsubscribe Link URL uses a submailinghash token macro, and the op-notrack parameter.

ℹ️

Unsubscribe Link URL

https://[client].app.optipub.com/messages/opt-outs/{$submailinghash}?op-notrack

At send time, the {$submailinghash} macro expands into a 64 character token created from the email recipient's Subscriber ID and the Mailing ID of the message or auto responder.

Unsubscribe Page

The Unsubscribe Link hosts a webpage with an unsubscribe form that must be submitted to perform the Unsubscribe Action.

During the Unsubscribe Action, OptiPub decodes the submailinghash, and matches the Subscriber ID to an email address and the Mailing ID to the message's Publication, and ends matching Subscriptions for that Publication.

🚧

Unsubscribe Link Limitation

The Unsubscribe Link ends subscriptions only on the publication that sent the message.

If you send a message to multiple publications, the Unsubscribe Link will only end subscriptions for the publication configured on the message.

Email Unsubscribe Macro

📘

{$sys_email_unsubscribe}

Use the {$sys_email_unsubscribe} macro in Templates to add an unsubscribe link URL to Messages and Auto Responders.

The macro expands to the Unsubscribe Link URL during message creation

This macro expands to the Unsubscribe Link URL, so it's just a URL, not a complete link element. Use the macro for the value of href or URL in a link element.

Removal Actions using the Unsubscribe Link

Adding certain URL parameters to the Unsubscribe Link can cause the Unsubscribe Action to modify the subscription, but when these parameters are used, it's not possible to end the subscription.

📘

Removal Parameter Values

In the parameter value, specify IDs for removal inside of square brackets and comma separated.

&parameter=[value1,value2]

Remove Subscription Tags

URL parameter: tag_ids=[x]

Adding the tag_ids parameter to the Unsubscribe Link removes those Subscription Tags from the subscription.

Remove Email from Segment

URL parameter: segment_ids=[x]

Adding the segment_ids parameter to the Unsubscribe Link removes the Email Address of the subscriber from those segments.

How to Add the Unsubscribe Link

Click Tracking Ignores Unsubscribe Links

The op-notrack parameter serves an important purpose, it prevents the unsubscribe link from getting converted into a click tracking link. This means unsubscribe link clicks are not tracked.

The op-notrack parameter can be added to any email link to prevent tracking.

Untracked link clicks:

• do not trigger funnels.
• are not matched in funnel or dynamic segment query conditions.
• are not considered for engagement
• are not included in click totals