Subscribe/unsubscribe links
This article explains what subscribe and unsubscribe links are and how to use them. These links are generated automatically for the audience. Including an unsubscribe link in all email sends is mandatory.
Variable implementation
System variables - the {{unSubscribeUrl}} and {{subscribeUrl}} variables are included in the template, and the system generates the corresponding links after delivery.
HTML integration - variables must be placed inside an <a> tag to function correctly.
Unsubscribe mechanisms
There are two primary ways for a contact to opt out of communication.
Unsubscribe variables
Process - the contact clicks the link generated by {{unsubscribeUrl}} (e.g., in the footer) and is unsubscribed from the email channel in the contact list.
Resubscription - the contact can be resubscribed through the API, automation, or by providing a subscription option on a website or in notification settings.
Reputation - the contact is not added to the blacklist. However, resubscribing contacts without their explicit consent is not recommended to avoid damage to the domain's reputation.
List-Unsubscribe mechanism
Process - the unsubscribe request is handled via the email service interface (e.g., Gmail).
Blacklist - contacts using this method are added to the system blacklist with the "list-unsubscribe" status.
Recovery - to resume sending (e.g., at the contact's request), the record must be manually removed from the blacklist.
Visibility - the button's display depends on the email service and is typically shown for domains with a good reputation.
Resubscription and confirmation
To prevent accidental unsubscribes, a secondary step is provided.
- Unsubscribe page - upon clicking the link, the contact is directed to an unsubscribe page where they can subscribe again.
- Subscribe link - a dedicated {{subscribeUrl}} can be included in emails to allow unsubscribed contacts to easily re-subscribe.
Redirect URL and identification
Redirect function - a specific site link can be configured to redirect after the contact clicks the button.
Contact identification - adding the ?email={{email}} parameter to the redirect URL enables contact identification on the external site.
External limitations - if variables are placed on an external page outside the Wooxy platform, they will not be available for managing contact status. In such cases, the subscription logic must be implemented on the external side.
Usage constraints
The {{subscribeUrl}} and {{unSubscribeUrl}} variables function only during:
- Campaigns
- Workflows
- A/B tests
- API method send triggered email
Important! Links are not automatically generated when sending a test email via the Email Preview function.
