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.
