---
title: Account Engagement Unsubscribe Tag Implementation
type: article
created: '2026-04-05'
updated: '2026-04-05'
source_docs:
- raw/2025-11-14-salesforceaccount-engagement-sync-101737737.md
tags:
- salesforce
- account-engagement
- email-marketing
- html
- unsubscribe
- compliance
layer: 2
client_source: null
industry_context: null
transferable: true
---

# Account Engagement Unsubscribe Tag Implementation

## Overview

Salesforce Account Engagement (formerly Pardot) requires a **dynamic unsubscribe tag** in the body of every HTML email template before it can be saved. A static hyperlink or plain text reading "unsubscribe here" is not sufficient — AE will reject the save with an error:

> *"The unsubscribe tag is required in the body of the email."*

This is a CAN-SPAM/GDPR compliance enforcement mechanism built into the platform. Every template must include the platform-specific merge tag so AE can render a functional, tracked unsubscribe link at send time.

---

## The Problem

When importing a custom HTML template into Account Engagement (**Marketing → Assets → Emails**), the save will fail if the template contains only a static unsubscribe link such as:

```html
<a href="https://example.com/unsubscribe">unsubscribe here</a>
```

AE cannot verify that this link will function as a real unsubscribe mechanism, so it blocks the save entirely.

This was encountered during the [[wiki/clients/asymmetric/index|Asymmetric]] email automation setup, where a designer-produced HTML template included static unsubscribe text that caused the template to be unsaveable in AE.

---

## The Fix

Replace the static unsubscribe link with Account Engagement's native unsubscribe merge tag. AE provides two primary options:

### Option 1 — Unsubscribe Link Tag (recommended)

```html
%%unsubscribe%%
```

This renders as a plain unsubscribe URL. Wrap it in an anchor tag for a clickable link:

```html
<a href="%%unsubscribe%%">Unsubscribe</a>
```

### Option 2 — Unsubscribe Preferences Center

```html
<a href="%%email_preference_center%%">Manage Email Preferences</a>
```

Use this if the account has an Email Preference Center configured — it gives prospects more granular control and is generally preferred for compliance.

### Minimal Compliant Footer Example

```html
<p style="font-size:11px; color:#888888;">
  You are receiving this email because you submitted a request on our website.<br>
  <a href="%%unsubscribe%%">Unsubscribe</a> | 
  <a href="%%email_preference_center%%">Manage Preferences</a>
</p>
```

---

## Implementation Steps

1. Open the HTML template source (coordinate with the designer — in the Asymmetric case, Raphael owns the template file).
2. Locate the existing unsubscribe text or link in the footer.
3. Replace the `href` value (or the surrounding anchor) with `%%unsubscribe%%` or `%%email_preference_center%%`.
4. In AE, navigate to **Marketing → Assets → Emails → New**.
5. Paste the updated HTML into the HTML editor.
6. Click **Save Draft** — the unsubscribe error should no longer appear.
7. Use **Preview** to verify the footer renders correctly and the placeholder image alignment looks correct before finalizing.

---

## Related Issues

### Image Alignment in Preview

When previewing a template in AE, placeholder images may appear misaligned. This is a separate issue from the unsubscribe tag and should be addressed by refining the HTML/CSS with the designer. In the Asymmetric project, this was flagged as a follow-up item between Chris and Raphael.

### Template Scope

A base template saved in AE is not itself sent to anyone — it serves as the starting point for building segment-specific email sends. Assign each derived email to the correct AE Campaign (e.g., Digital Fabrication, Traditional Fabrication, Fine Art) so that open/click metrics are attributed correctly per segment. See [[wiki/knowledge/email-marketing/account-engagement-campaign-structure|Account Engagement Campaign Structure]] for details.

---

## Key References

- **Client context:** [[wiki/clients/asymmetric/index|Asymmetric]] — email automation setup for three fabrication segments
- **Related meeting:** [[wiki/clients/asymmetric/meetings/2026-04-05-ae-email-automation-setup|AE Email Automation Setup Sync]]
- **Related blocker:** [[wiki/knowledge/integrations/gravity-forms-salesforce-sync|Gravity Forms → Salesforce Sync Configuration]]

---

## Notes

- Every AE HTML email template must contain `%%unsubscribe%%` or `%%email_preference_center%%` — this is non-negotiable and cannot be bypassed.
- The tag must appear in the `<body>` of the HTML, not in a comment or hidden element.
- If the account does not have a Preference Center configured, `%%email_preference_center%%` will render as a broken link — use `%%unsubscribe%%` as the safe default.
- AE also supports `%%unsubscribe_text%%` which renders the word "Unsubscribe" as a pre-linked string, useful for plain-text versions.