Overview
Knak supports Marketo's system unsubscribe token:
{{system.unsubscribeLink}}
You can use this token directly in your emails. You can also create a Knak merge tag that references the token. Using a merge tag makes the unsubscribe link easier to manage across templates.
Create a Knak Merge Tag for Your Unsubscribe Link
Create a merge tag that maps to Marketo's unsubscribe token.
Create the Unsubscribe Merge Tag
Go to Admin > Integrations.
Select Merge Tags.
Click Create New Merge Tag.
Enter a name, such as Unsubscribe Link.
In the Marketo value field, enter:
{{system.unsubscribeLink}}(Optional) Enable Special Link if you want the merge tag to appear in link selectors throughout the editor.
Save the merge tag.
Add the Unsubscribe Merge Tag to an Email
Open your email.
Click inside a text box.
Click Tags in the inline editor.
Select your unsubscribe merge tag.
Note: If you enabled Special Link when creating the merge tag, the merge tag appears under Links instead of Tags.
Verify Your Unsubscribe Link
After adding the merge tag, test the unsubscribe experience.
Sync your email to Marketo
Send a test email from Marketo.
Open the email.
Click the unsubscribe link.
Confirm the unsubscribe page loads correctly.
Confirm the unsubscribe process completes successfully.
Note: The unsubscribe token is generated by Marketo. You must sync your email to Marketo before testing the unsubscribe link.
If the email has not been synced to Marketo, the unsubscribe token cannot be resolved and the link will not work.
Unsubscribe Link Best Practices
Follow these recommendations to ensure your unsubscribe link functions correctly.
Use the Default Marketo Token
Use: {{system.unsubscribeLink}}
Do not:
Modify the token
Wrap the token in custom code
Add conditional logic
Place the token inside dynamic content
Place the Link in Static Content
Unsubscribe links are managed by Marketo.
For best results:
Place unsubscribe links in static content areas
Avoid dynamic content sections
Avoid personalization logic around the unsubscribe link
Dynamic content can interfere with unsubscribe functionality.
Localize Your Unsubscribe Experience
Translate Only the Link Text
Translate the text that users click. Do not translate the token itself.
The token remains the same in every language:
{{system.unsubscribeLink}}
Use Language-Specific Unsubscribe Pages
If you require fully localized unsubscribe pages:
Create a separate landing page for each language.
Link directly to each landing page.
Do not use the Marketo system token for those links.
This approach provides complete control over the unsubscribe experience for each language.
Update Your Unsubscribe Page URL in Marketo (if needed)
Step 1: Open Your Landing Page URL Settings
Locate your unsubscribe landing page in Marketo.
Click Landing Page Actions.
Select URL Tools.
Click Edit URL Settings.
Step 2: Update the Page URL
In the URL settings, locate the page URL field.
Enter:
UnsubscribePageSave your changes.
Marketo will generate the required URL:
UnsubscribePage.html
Need more help? Contact support via live chat within Knak using the chat bubble in the bottom right corner or email support@knak.com.