For the complete documentation index, see llms.txt. This page is also available as Markdown.

Common Footer & Unsubscribe Link Mistakes (and How to Fix Them)

A badly built unsubscribe link is one of the most common, and most avoidable, causes of deliverability damage. When a recipient can't find or use the unsubscribe link, they don't stay subscribed: they click "Report spam" instead, which harms sender reputation far more than a clean unsubscribe would.

Unsubscribe experience

These mistakes all affect the same thing: whether a recipient can actually act on their decision to leave, not just whether a link technically exists somewhere in the email.

The unsubscribe link is present, but hard to find: small font, low contrast, buried at the very bottom of a long email.

In long emails, Gmail (and some other inbox providers) clips emails once they exceed 102KB, displaying "[Message clipped] View entire message" instead of the rest of the content. If your unsubscribe link sits below that cutoff, recipients never see it.

See Why is Gmail clipping emails? to check your template size and identify what's inflating it (embedded vs. enclosed images are a common culprit).

Some templates only offer a "manage preferences" link with no way to actually leave the list entirely, or the unsubscribe link is broken (wrong URL, dead landing page, missing attribute).

The link resolves and the destination page works, but the experience is designed in a way that most recipients won't complete:

  • The preference page asks the recipient to type in their email address before they can update anything.

  • Preferences sit behind a login wall, requiring an account and password recipients may not remember.

Both add enough friction that a real share of recipients give up and mark the email as spam instead: the exact outcome the unsubscribe link was supposed to prevent.

Email Composer variable used in raw HTML

{{emailComposerUnsubscribeLink()}} only works inside the drag-and-drop Email Composer. When a template built in the Composer gets exported or rebuilt as raw HTML (during a redesign or migration, for example), this variable doesn't resolve, and the footer silently breaks.

See How to add an unsubscribe link to your email template? for the full implementation guide, including localized variants.

Confusing opt-out scope

Recipients sometimes unsubscribe expecting to leave one newsletter and find they've opted out of everything, or the reverse, they think they've unsubscribed globally but keep receiving other campaigns.

About List-Unsubscribe / List-Unsubscribe-Post headers These headers power Gmail and Yahoo's one-click "Unsubscribe" button next to the sender name. Batch includes them by default on marketing sends: no manual configuration needed. If the button isn't showing up, the cause is almost always sending reputation or authentication alignment, not header configuration. See Why Doesn't Gmail Always Show the "Unsubscribe" Button in your Marketing Emails?

Separate from the unsubscribe mechanism itself: what the footer needs to say to be compliant and trustworthy.

Missing physical address or illegitimate linked site

Batch guidelines require a physical address in the footer, linked to a legitimate, reachable website on the sending domain.

Beyond the address, inbox providers expect the domain behind your emails to lead somewhere that identifies who's sending, why the recipient is hearing from them, and under what terms. A footer that skips a privacy policy link (or a sending domain whose linked site has no legal notices at all) reads the same way to a mailbox provider as a missing address: a sign the sender isn't fully accountable.

Last updated