Customerly is an Italian customer messaging and marketing automation platform combining live chat, email marketing, in-app messages, and video for SaaS and e-commerce teams. The unsubscribe mechanism uses the {{unsubscribe_link}} Liquid tag in email templates, with automatic RFC 8058 header injection for authenticated domains. This guide covers the tag, the unified subscriber model across chat and email, and how to verify the setup end to end.
Customerly.io unsubscribe link
| Tag syntax | {{unsubscribe_link}} |
| Placement | Auto-embedded in default email footer |
| Scope | Per-channel email opt-out with unified contact record |
| Config path | Workspace Settings > Domains |
| RFC 8058 one-click | Yes, automatic for authenticated sender domains |
How to add the unsubscribe tag in Customerly.io
Place the merge tag exactly as shown below in the email template. Customerly.io replaces it at send time with a signed URL scoped to the recipient and campaign.
{{unsubscribe_link}}For custom HTML templates, wrap the tag in an anchor to render a proper hyperlink in the delivered email:
<a href="{{unsubscribe_link}}">Unsubscribe from this list</a>Auto-embedded in default email footer
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.
Email unsubscribe on Customerly applies only to email marketing broadcasts, preserving live chat replies and in-app notifications on the same contact. Workspace settings can enforce cross-channel opt-out that also disables in-app marketing messages. Consumer SaaS brands typically choose cross-channel; B2B teams keep per-channel control to preserve transactional in-app notifications.
Testing your Customerly.io unsubscribe link
- Send a test message to a controlled Gmail address you own via the Customerly.io campaign preview action
- Click the footer unsubscribe link and confirm the opt-out on the landing page
- Check the subscriber or contact record: the status should be Unsubscribed within seconds
- Verify the RFC 8058 headers in Gmail: open the message, click three dots, then Show original. Look for
List-UnsubscribeandList-Unsubscribe-Post: List-Unsubscribe=One-Click
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 →
How to add the Customerly unsubscribe link (step by step)
Customerly email templates ship with the unsubscribe link in the default footer, but custom templates or transactional-style broadcasts require the tag inserted manually.
- Open your email campaign or template in the Customerly editor under Marketing > Email.
- Add or edit a text block in the footer where the unsubscribe link should appear.
- Insert the Liquid tag
{{unsubscribe_link}}. Customerly replaces it at send time with a signed URL unique per contact. - Wrap in an anchor with your preferred label:
<a href="{{unsubscribe_link}}">Unsubscribe</a>. - Add the physical postal address block. Customerly reads it from Workspace Settings > Company Info.
- Send a test to a seed address and verify the rendered link routes to the Customerly-hosted preference page.
Unified contact model and channel behavior
Customerly treats every contact as a single record spanning live chat, email marketing, and in-app messaging. An email unsubscribe removes the contact from marketing broadcasts but preserves the ability to receive transactional messages, chat replies, and in-app notifications. This is a natural fit for SaaS onboarding flows where a user may opt out of promotional emails while still expecting product updates through in-app channels. Workspace settings can enforce a stricter policy where email unsubscribe also disables in-app marketing messages for the same contact.
RFC 8058 one-click headers
Customerly added RFC 8058 one-click unsubscribe support in 2024. The List-Unsubscribe and List-Unsubscribe-Post headers inject on every marketing send from domains authenticated under Workspace Settings > Domains. SPF and DKIM records must be verified for the sending domain. Transactional-style automated messages (welcome flows, onboarding sequences) inherit the same authentication and get the headers as well, giving consistent one-click behavior across the account.
GDPR and European positioning
As an Italian platform serving European SaaS heavily, Customerly defaults to GDPR-oriented behavior: double opt-in available at the workspace level, consent records tracked per contact (timestamp, source, IP), and permanent suppression on opt-out that blocks API reactivation. Reactivation requires the subscriber to re-opt in through a Customerly signup form, triggering a fresh double opt-in confirmation. Data residency is available in the EU region on Business tier and above.
Frequently Asked Questions
What is the Customerly unsubscribe tag?
The tag is {{unsubscribe_link}}. Customerly replaces it with a signed URL unique per contact at send time. Use it inside an anchor: <a href="{{unsubscribe_link}}">Unsubscribe</a>.
Does an email unsubscribe stop live chat and in-app messages?
No by default. Email unsubscribe applies only to email marketing broadcasts, preserving live chat replies and in-app notifications. Workspace settings can enforce cross-channel opt-out that disables in-app marketing messages as well.
Does Customerly support one-click unsubscribe for Gmail and Yahoo?
Yes, automatically for authenticated domains. Customerly injects List-Unsubscribe and List-Unsubscribe-Post headers on every marketing send from domains verified under Workspace Settings > Domains, meeting the Google and Yahoo bulk-sender requirements.
Can I resubscribe a contact who unsubscribed from Customerly?
No, not through the API. Customerly enforces permanent suppression on email opt-outs and blocks API-driven reactivation. The contact must re-opt in through a Customerly signup form, which triggers a fresh double opt-in confirmation.
Can I customize the Customerly unsubscribe preference page?
Yes on paid plans. The Customerly-hosted preference page supports branding (logo, colors, workspace name) and exposes topic-level checkboxes when categories are configured. Free-tier accounts get the default Customerly-branded page.
About the 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.
