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