# Unsubscribe & Preferences Settings (Premium Version)

The **Opt-In & Unsubscribe** tab under **GravityOps → Mass Notifications**
builds on the free version by adding customization options and advanced
preference controls for Premium users.

While the free version provides a simple automatic footer, the premium
upgrade gives you full control over how unsubscribe links appear, where
they lead, and how recipients can manage their preferences.

------------------------------------------------------------------------

### Method Options

The **Method** setting determines how recipients interact with
unsubscribe links:

- **Do nothing** – Keeps current behavior. No unsubscribe link or form
  is added. Can still use merge tags on a feed by feed basis.
- **Add unsubscribe link to all emails** – Appends a customizable footer
  to every Mass Email Notification.
- **Use a Gravity Form landing page** – Routes users to a dedicated form
  where they can manage preferences or pause emails.

------------------------------------------------------------------------

### Add Unsubscribe Headers

Enabling this checkbox adds standard **List-Unsubscribe headers** to
outgoing emails. These headers may allow Gmail and other clients to
display a built-in *Unsubscribe* button.

This feature is **safe but experimental**—its visibility depends on
factors such as:

- Whether Gmail can access the unsubscribe URL (not possible in local
  development).
- The type of email (bulk or promotional messages qualify more often
  than transactional emails).
- Your domain’s sender reputation and authentication.
- Other plugins or SMTP services preserving headers intact.

It won’t harm deliverability even if Gmail doesn’t display the button.

------------------------------------------------------------------------

### Unsubscribe Link Text and Landing Page

If you select **Add unsubscribe link to all emails**, two text fields
appear:

- **Unsubscribe Link Text** – Customize the text shown in the footer.
  Defaults to “To stop receiving these emails, unsubscribe.”
- **Landing Page URL** – Choose where users go after clicking the link.
  This page replaces the generic confirmation screen from the free
  version.

Both fields are optional but allow you to create a more branded
experience.

------------------------------------------------------------------------

### Merge Tag Options

Merge tags let you insert unsubscribe links anywhere in your message
template, giving you per-feed control:

- **Merge Tag Link Text** – Customize the anchor text for unsubscribe
  merge tags.
- **Merge Tag Landing Page URL** – Set a landing page for these links
  (for example, a custom “You’ve been unsubscribed” message or
  preferences portal).

Use these merge tags within a feed to generate unsubscribe URLs specific
to that campaign.

------------------------------------------------------------------------

### Gravity Form Preferences Page

When **Use a Gravity Form landing page** is selected, additional fields
appear to map how user preferences are handled:

- **Unsubscribe/Preferences Form (Required)** – Choose the Gravity Form
  that will act as your preferences page.
- **Email Field (Required)** – The field used to pre-fill the
  recipient’s email address when they click the link and process what
  email to unsubscribe.
- **Pause Until Field (Optional)** – A Date or Number field. When
  filled, the system pauses messages until the specified date or
  duration instead of unsubscribing immediately.
- **Form Link Text** – Customize the anchor text for links that direct
  users to this form (defaults to “Manage Preferences”). When this
  method is active, two additional merge tags become available in each
  feed: one for the full unsubscribe URL and another for the unsubscribe
  link itself. The link merge tag supports custom link text, and one of
  these two merge tags must be used to ensure proper unsubscribe
  functionality.
- **Control Field (Optional)** – A choice-based field (checkboxes,
  radio, select, or multiselect) used to group feed subscriptions.
  Each choice can be mapped to specific feeds, allowing fine-grained
  opt-outs—e.g., unsubscribing from *Marketing* but keeping *Updates*.
- **Unsubscribe Page URL (Required)** – The URL of the page where the
  selected form is embedded.

After you choose a form, its email, pause, and control fields load
automatically. After you choose a control field, a mapping grid appears
so each form choice can be assigned to one or more feeds.

------------------------------------------------------------------------

### Viewing and Managing Suppressed Recipients

You can view and manage unsubscribed or paused recipients in the **Suppressions** tab under **GravityOps → Mass Notifications**.

The table includes:

- **Email** – Address of the recipient.
- **Global Status** – Whether the user is globally paused or
  unsubscribed.
- **Feeds** – Lists which feeds or campaigns the status applies to.
- **Updated** – Timestamp of the most recent change.

Premium users see **Remove** buttons next to each entry, plus a **Remove
All** option for quickly resubscribing an address to all feeds.

------------------------------------------------------------------------

### Behavior Summary

- The feature remains optional—emails behave as usual if all options are
  left off.
- Choose between automatic footers, merge tag links, or form-based pages
  for different workflows.
- Multiple methods can coexist (e.g., include both “Unsubscribe” and
  “Manage Preferences” links).
- Gmail headers can be safely enabled but may or may not display
  depending on client behavior.
- The Suppressions tab is fully editable for Premium users.

Together, these tools allow complete control over how recipients manage
their subscriptions and give you the flexibility to match your email
compliance to your brand and workflow.
