View Categories

Troubleshooting Unsubscribe & Preferences Issues

Table of Contents

If your unsubscribe or preferences setup isn’t working as expected, use the following guide to identify and fix common issues.

1. Unsubscribe Link Leads to 404 or Blank Page #

Cause: The landing page URL is missing, incorrect, or private.

Fix:

  • Double-check the Landing Page URL or Unsubscribe Page URL in your settings.
  • Ensure the page is published and publicly accessible (not set to draft or private).
  • If using the Gravity Form method, verify the page contains the correct form.

2. Email Address Not Prefilling on Preferences Form #

Cause: The Email Field in your form isn’t mapped correctly.

Fix:

  • Go to Mass Email → Settings → Unsubscribe Settings and confirm you selected the correct Email Field.
  • Make sure your form includes a valid Email field (type must be Email).

3. User Not Appearing in Unsubscribe List #

Cause: The unsubscribe link didn’t register, or the action wasn’t processed yet.

Fix:

  • Refresh the View Unsubscribed modal.

4. Gmail Unsubscribe Button Not Showing #

Cause: Gmail decides whether to display the unsubscribe option based on multiple factors.

Fix:

  • Confirm Add Unsubscribe Headers is enabled.
  • Make sure Gmail can reach your unsubscribe URL (this will not work on localhost or private servers).
  • Gmail may hide the button for transactional emails or senders with low reputation.
  • Some SMTP or security plugins can strip required headers; test by disabling them temporarily.
  • Note: this feature is experimental and may not appear even if configured correctly.

5. Merge Tags Not Resolving #

Cause: Merge tags are used incorrectly or in the wrong context.

Fix:

  • Verify that you’re using the correct merge tags:
    • {menfgf_unsubscribe_url} and {menfgf_unsubscribe_link} – available unless the method is set to automatic footer.
    • {menfgf_unsubscribe_form_url} and {menfgf_unsubscribe_form_link} – available only when the Gravity Form method is selected.
  • Make sure merge tags are inserted in the feed message body and not in form fields or other plugins.
  • Save and refresh the feed after adding merge tags.

6. Users Can’t Be Resubscribed #

Cause: Free version limitation or permissions.

Fix:

  • Free users cannot resubscribe recipients once unsubscribed.
  • Premium users can remove them using Remove or Remove All buttons inside the View Unsubscribed modal.

8. Unsubscribe Headers Present But Not Working #

Cause: Email clients handle unsubscribe headers differently.

Fix:

  • Verify headers are added (check via email source in Gmail → Show Original).
  • Confirm the link within the header is valid and publicly accessible.
  • Understand that not all clients show this button; some ignore unsubscribe headers entirely.

9. Still Stuck? #

If the problem persists:

  • Temporarily disable other email-related plugins and retest.
  • Enable WordPress debug mode and check logs for errors related to Gravity Forms or Mass Email Notifications.
  • Contact support with screenshots of your Unsubscribe Settings panel and form setup.

By checking each area above, most unsubscribe or preferences issues can be resolved without needing advanced debugging.

What are your Feelings