---
title: "Troubleshooting Unsubscribe & Preferences Issues"
description: "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…"
url: "https://brightleafdigital.io/docs/troubleshooting-unsubscribe-preferences-issues/"
updated: "2026-10-18"
category: Mass Email Notifications for Gravity Forms / Troubleshooting
---

# Troubleshooting Unsubscribe & Preferences Issues

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 **Suppressions** tab.

---

### 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 **Suppressions** tab.

---

### 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.