Unsubscribes

When sending bulk email messages in OptiPub, always provide an opt-out method in the email body.

Inbox Providers penalize your sending domain and IP when a recipient uses their Inbox Provider's unsubscribe methods instead of your own.

📘

Add opt-out methods to the Template whenever possible so every message includes them automatically.

Unsubscribe Actions

OptiPub's unsubscribe link supports three different opt-out actions depending on URL parameters.

🚧

Only One Action Per Link

When tag_ids or segment_ids parameters are present, the subscription is not ended. Only the specified tags or segment memberships are removed.

Unsubscribe from Publication

The default behavior when no additional URL parameters are used. Clicking the link and submitting the hosted form ends the subscriber's active subscription on the publication that sent the message.

This is the standard opt-out for Free Subscriptions and most general use cases.

🚧

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.

Remove from Tag

Adding the tag_ids parameter to the unsubscribe link removes the specified Subscription Tags from the subscription. The subscription itself remains active.

This is useful when you use tags to control which types of content a subscriber receives. For example, a subscriber could opt out of marketing emails by removing a marketing tag while still receiving content emails.

Remove from Segment

Adding the segment_ids parameter to the unsubscribe link removes the subscriber's email address from the specified Segments. The subscription itself remains active.

This is useful when segment membership determines what messages a subscriber receives, such as removing someone from a promotional segment without ending their subscription.

Choosing an Opt-Out Strategy

Free Subscriptions

Free Subscriptions should use the default unsubscribe link to end the subscription in a single action.

Use either the Email Unsubscribe Link or Email Unsubscribe Macro for the opt-out method. Both work everywhere you create or edit email messages.

Paid Subscriptions

Paid Subscriptions usually have a term length attached to the purchase, where it's not advisable for the email opt-out method to end their subscription completely.

Ending the subscription could lock a customer out of other paid services, or allow duplicate purchases.

The best opt-out option for Paid Subscriptions is usually to add the email address to a Segment and set up an Excluded Auto-Selected Segment for that Segment on the Publication.

Mixed Content Types

When you send different types of email (e.g., marketing and content) through the same Publication, you can use tag-based or segment-based unsubscribe links to let subscribers opt out of specific content without fully unsubscribing.

1. Add the tag_ids or segment_ids parameter to the unsubscribe link in the relevant messages
2. Configure the Sendable or Excluded Dynamic Segment on the Publication to include or exclude subscribers based on those Tags or Segments

Contact the OptiPub Team for support determining an appropriate strategy.

Unsubscribe Link in Email

Link URL

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 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 Parameters

Adding URL parameters to the unsubscribe link changes the opt-out action. When these parameters are present, the subscription is not ended — only tags or segment memberships are removed.

📘

Removal Parameter Values

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

&parameter=[value1,value2]

Remove Subscription Tags: tag_ids=[x]

Adding the tag_ids parameter removes those Subscription Tags from the subscription.

Remove Email from Segment: segment_ids=[x]

Adding the segment_ids parameter removes the subscriber's email address from those Segments.

Click Tracking Ignores Unsubscribe Links

The op-notrack parameter 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

Hosted Unsubscribe Page

When a subscriber clicks an unsubscribe link, they are taken to a hosted page with a confirmation form. The subscriber must submit the form to complete the opt-out action.

During the unsubscribe action, OptiPub decodes the submailinghash, matches the Subscriber ID to an email address and the Mailing ID to the message's Publication, and performs the appropriate action based on the URL parameters.

Customizing Page Content

You can add custom HTML content above and below the unsubscribe form through Publication Settings.

1. Navigate to the Publication settings
2. Find the Unsubscribe Page HTML (Before Form) and Unsubscribe Page HTML (After Form) fields
3. Enter custom HTML content to display on the hosted unsubscribe page

Use this to add branding, messaging, alternative options, or a re-engagement offer around the unsubscribe form.