Unsubscribe / Opt-Out Handling for Recovery Emails

Every recovery email you send must include a working unsubscribe option. It’s a legal requirement under CAN-SPAM, GDPR, and most other email regulations — and it also protects your sender reputation.

This guide shows you how to:

• Add the built-in unsubscribe link to every recovery email
• Manually unsubscribe customers from the admin dashboard
• Honor unsubscribe requests that come through other channels

How Unsubscribe Works in Cart Abandonment Recovery

The plugin generates a unique unsubscribe URL for each customer using a secure token. When a customer clicks it:

1. Their email is added to the plugin’s internal opt-out list.
2. No further recovery emails will be sent to that address.
3. A confirmation message is shown to them.

The URL format looks like:

https://yourstore.com/?unsubscribe=true&wcf_ac_token=<unique-token>

This token is unique per customer and can’t be guessed — so it’s safe to include in emails.

Prerequisites

• Cart Abandonment Recovery plugin installed and activated
• At least one email template created under Follow Up Templates

Step-by-Step: Adding the Unsubscribe Link to Emails

Step 1 — Open the Template Editor

Go to WooCommerce > Cart Abandonment > Follow Up Templates and click the ️Edit icon on the template you want to edit. The editor opens as a right-side drawer.

Step 2 — Add the Shortcode

Insert {{cart.unsubscribe}} wherever you want the unsubscribe link to appear — typically in the footer.

Step 3 — Save the Template

Click Save Changes.

Step 4 — Repeat for All Templates

Make sure every recovery email template has the unsubscribe link — not just the first one.

Step 5 — Test

Use the Send Test Email feature to verify the unsubscribe link renders correctly and works when clicked.

Manually Unsubscribing a Customer

You can opt out a customer directly from the admin dashboard.

1. Go to Reports > Follow Up and search for the customer’s email.
2. Click the Unsubscribe action in the row.

Use this when:

• A customer emails asking to be removed
• You’re cleaning up a stale list
• You want to opt out specific test accounts

Pro Feature: Blacklist (Permanent Block)

Cart Abandonment Recovery Pro adds a Blacklist feature that goes beyond regular unsubscribe. A blacklisted email is:

• Never tracked — the cart isn’t even stored in the database.
• Never sent any recovery message — email, SMS, or WhatsApp.
• Protected from accidental re-subscription — an admin must manually remove them from the blacklist.

When to Blacklist vs. Unsubscribe

How to Add an Email to the Blacklist

1. Go to WooCommerce > Cart Abandonment > Settings > Blacklist (Pro)
2. Enter the email address (one per line) or a domain pattern.
3. Click Save.

How to Remove From the Blacklist

Remove the entry from the Blacklist list and save. The next cart that customer abandons will be tracked again.

Blacklist ≠ data deletion. Blacklist prevents future tracking but doesn’t delete past cart records. For GDPR right-to-erasure, also delete existing records from Reports.

Honoring Out-of-Band Unsubscribe Requests

Sometimes customers will request removal through:

• A direct email reply
• A phone call
• A social media message
• A written request (for GDPR compliance)

When this happens:

1. Search for their email in the Reports tab.
2. Click Unsubscribe on all matching rows.
3. If they also want their data deleted (GDPR right-to-erasure), delete the records as well.
4. Reply to confirm action taken.

Tips & Best Practices

• Always include unsubscribe_link — it’s not optional, even for a single follow-up email.
• Make the unsubscribe link visible — don’t hide it in tiny grey text at the bottom.
• Process unsubscribe requests within 10 business days (CAN-SPAM requirement) — ideally faster.
• Don’t require login to unsubscribe — the token-based link should work without any authentication.
• Confirm the unsubscribe — show a clear “You’ve been unsubscribed” message.

Troubleshooting

Unsubscribe Link Shows Literal {{unsubscribe_link}} in Email

• Check spelling — the tag is case-sensitive
• Ensure double curly braces {{ }} are used
• Re-save the template and re-test

“404 Not Found” When Clicking the Link

• Check that WordPress permalinks are set correctly
• Confirm the plugin is active
• Regenerate permalinks by visiting Settings > Permalinks and clicking Save Changes

Customer Is Still Receiving Emails After Unsubscribing

1. Verify they were actually added to the opt-out list (check their cart entry in Reports)
2. Confirm the email template is sending to them (may already be queued)
3. Check your email provider logs for delivery status

Legal Compliance Notes

Different jurisdictions have different requirements:

FAQs