wiki/knowledge/email-marketing/account-engagement-unsubscribe-tag.md · 628 words · 2026-04-05

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:

<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 [1] 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:

%%unsubscribe%%

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

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

Option 2 — Unsubscribe Preferences Center

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

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

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 [2] for details.


Key References


Notes

Sources

  1. Index|Asymmetric
  2. Account Engagement Campaign Structure|Account Engagement Campaign Structure
  3. 2026 04 05 Ae Email Automation Setup|Ae Email Automation Setup Sync
  4. Gravity Forms Salesforce Sync|Gravity Forms → Salesforce Sync Configuration