How to Add a XtremePush Unsubscribe Link: The Complete 2026 Guide

Discover how to dynamically insert the Xtremepush unsubscribe link to ensure compliance and enhance engagement, follow our step-by-step guide to get started today.
Alaa
By Alaa
SMTPedia documents email infrastructure end to end: SMTP standards from the RFC archive, delivera...
4 min read Updated Jul 28, 2026 99 views

XtremePush is an Irish multi-channel customer engagement platform serving mid-market and enterprise B2C brands (iGaming, retail, financial services) with push notifications, email, SMS, in-app messaging, and Web Push from a unified user model. The email unsubscribe mechanism uses the {{unsubscribe_url}} Liquid tag in email templates, and XtremePush emits RFC 8058 headers automatically for authenticated domains. Consent is tracked per channel by default with cross-channel enforcement available. This guide covers the tag, the multi-channel model, and how to verify the setup end to end.

Quick reference

xtremepush unsubscribe link

Tag syntax{{unsubscribe_url}}
PlacementAuto-embedded in default email footer
ScopePer-channel opt-out with cross-channel option
Config pathSettings > Channels > Email > Sender configuration
RFC 8058 one-clickYes, automatic for authenticated sender domains

How to add the unsubscribe tag in xtremepush

Place the merge tag exactly as shown below in the email template. xtremepush replaces it at send time with a signed URL scoped to the recipient and campaign.

{{unsubscribe_url}}

For custom HTML templates, wrap the tag in an anchor to render a proper hyperlink in the delivered email:

<a href="{{unsubscribe_url}}">Unsubscribe from this list</a>
Default footer

Auto-embedded in default email footer

RFC 8058 one-click: automatic

Yes, automatic for authenticated sender domains The recipient's mailbox provider (Gmail, Yahoo) uses the List-Unsubscribe-Post header to expose the native one-click button on the message. Requires domain authentication with DKIM and DMARC.

!
Watch out for this

XtremePush is popular in the iGaming vertical which has strict regulatory requirements around unsubscribe handling and consent capture. iGaming operators must configure the Regulatory Compliance module to enforce jurisdiction-specific opt-out defaults (UK, Malta, Sweden all have different requirements). Missing this configuration causes compliance violations on cross-border sends to regulated markets.

Testing your xtremepush unsubscribe link

  1. Send a test message to a controlled Gmail address you own via the xtremepush campaign preview action
  2. Click the footer unsubscribe link and confirm the opt-out on the landing page
  3. Check the subscriber or contact record: the status should be Unsubscribed within seconds
  4. Verify the RFC 8058 headers in Gmail: open the message, click three dots, then Show original. Look for List-Unsubscribe and List-Unsubscribe-Post: List-Unsubscribe=One-Click
S

Want the full 222-platform reference?

See the pillar guide with the compliance landscape, the RFC 8058 deep dive, and the unsubscribe tag for every ESP: How to add an unsubscribe link: the complete 2026 guide →

XtremePush email templates include the unsubscribe link in the default footer, but custom HTML templates and campaign-specific templates may require the tag inserted manually.

  1. Open your email campaign or template in the XtremePush dashboard.
  2. Add or edit a text block in the footer where the unsubscribe link should appear.
  3. Insert the Liquid tag {{unsubscribe_url}}. XtremePush replaces it at send time with a signed URL scoped to the user record.
  4. Wrap it in an anchor: <a href="{{unsubscribe_url}}">Unsubscribe</a>.
  5. Configure the sending domain under Settings > Channels > Email > Sender configuration. SPF and DKIM must be verified.
  6. Send a test to a seed address and verify the rendered link routes to the XtremePush-hosted preference page.

Per-channel opt-out and unified user model

XtremePush unifies user profiles across channels (push, email, SMS, in-app, Web Push) but tracks opt-out per channel independently by default. A user unsubscribing from email marketing keeps receiving promotional push and SMS unless cross-channel enforcement is enabled at the org level. Consumer brands typically enable cross-channel to respect blanket opt-outs; B2B senders and iGaming operators often keep per-channel control since a user may want transactional push (deposit confirmation) but not marketing emails.

RFC 8058 one-click headers

XtremePush added RFC 8058 one-click unsubscribe automatically ahead of the Google and Yahoo February 2024 requirements. The List-Unsubscribe and List-Unsubscribe-Post headers inject on every marketing email send from domains authenticated under Settings > Channels > Email > Sender configuration. SPF and DKIM records must be verified. Push, SMS, and Web Push channels are exempt from RFC 8058 which targets email specifically.

iGaming compliance and regulatory jurisdictions

XtremePush is popular in the iGaming vertical which has strict regulatory requirements around unsubscribe handling and consent capture. iGaming operators must configure the Regulatory Compliance module to enforce jurisdiction-specific opt-out defaults (UK Gambling Commission, Malta Gaming Authority, Sweden Spelinspektionen all have different requirements). Missing this configuration causes compliance violations on cross-border sends to regulated markets, exposing operators to license risks and fines. Non-iGaming brands can skip this module.

Frequently Asked Questions

What is the XtremePush email unsubscribe tag?

The tag is {{unsubscribe_url}}. XtremePush replaces it at send time with a signed URL scoped to the user record. Use it inside an anchor: <a href="{{unsubscribe_url}}">Unsubscribe</a>.

Does an email unsubscribe stop push and SMS on XtremePush?

No by default. Email unsubscribe applies only to the email channel, preserving push, SMS, in-app, and Web Push subscriptions. Enable cross-channel enforcement at the org level to make one unsubscribe click apply across every channel simultaneously.

Does XtremePush support one-click unsubscribe for Gmail and Yahoo?

Yes, automatically for authenticated domains. XtremePush injects List-Unsubscribe and List-Unsubscribe-Post headers on every marketing email send from domains verified under Settings > Channels > Email > Sender configuration.

How does XtremePush handle iGaming regulatory unsubscribe requirements?

Via the Regulatory Compliance module which enforces jurisdiction-specific opt-out defaults for UK, Malta, Sweden, and other iGaming markets. Configure the module per licensing jurisdiction to meet regulator expectations. Non-iGaming brands can skip this module.

Can I customize the XtremePush preference center?

Yes. The preference center supports enterprise branding (logo, colors, brand identity) and per-channel opt-out toggles. Enterprise accounts can host the preference page under a custom subdomain via CNAME configuration.


About the Author

Alaa - SMTPedia author

Alaa · LinkedIn

Email infrastructure specialist with 8+ years of hands-on experience in SMTP, deliverability, and email verification. I’ve configured and troubleshot mail systems across Postfix, Exchange, and cloud relays, managed IP reputation and warmup campaigns, and built verification pipelines processing millions of addresses. My work spans DNS authentication (SPF, DKIM, DMARC, BIMI), bounce handling, blocklist monitoring, and compliance frameworks including CAN-SPAM and GDPR. I write every article on SMTPedia to give email professionals, developers, and marketers the accurate, RFC-grounded reference they need.


About SMTPedia

SMTPedia is an independent email industry reference covering SMTP, IMAP, POP3, email deliverability, marketing platforms, DNS authentication, and email verification. Every article is researched from official provider documentation, IETF RFCs, and industry best practices. Settings and configurations are verified quarterly.

We are cited as a source by ChatGPT, Microsoft Copilot, and thousands of email professionals worldwide. Learn more about our editorial process.