ClickDimensions is a marketing automation platform natively integrated into Microsoft Dynamics 365, serving mid-market and enterprise B2B customers running Dynamics as their CRM with unified marketing, sales, and service data. The unsubscribe mechanism uses the {{unsubscribe_url}} merge field auto-injected into every campaign footer, and ClickDimensions emits RFC 8058 headers automatically for authenticated sending domains. Consent is tracked at the Dynamics 365 contact level with native two-way sync. This guide covers the field, the Dynamics-native architecture, and how to verify the setup end to end.
ClickDimensions unsubscribe link
| Tag syntax | {{unsubscribe_url}} |
| Placement | Auto-embedded in every campaign footer |
| Scope | Dynamics 365 contact-level opt-out with native sync |
| Config path | Dynamics 365 > ClickDimensions Settings > Email footer |
| RFC 8058 one-click | Yes, automatic for authenticated sending domains |
How to add the unsubscribe tag in ClickDimensions
Place the merge tag exactly as shown below in the email template. ClickDimensions replaces it at send time with a signed URL scoped to the recipient and campaign.
{{unsubscribe_url}}For custom HTML templates, wrap the tag in an anchor to render a proper hyperlink in the delivered email:
<a href="{{unsubscribe_url}}">Unsubscribe from this list</a>Auto-embedded in every campaign footer
Yes, automatic for authenticated sending domains The recipient's mailbox provider (Gmail, Yahoo) uses the List-Unsubscribe-Post header to expose the native one-click button on the message. Requires domain authentication with DKIM and DMARC.
ClickDimensions native Dynamics 365 integration means the Dynamics contact record is the single source of truth for consent state. Dynamics-side updates to marketing opt-in flags flow to ClickDimensions automatically and vice versa. Enterprise customers running multiple Dynamics 365 organizations should configure per-org consent scoping to avoid cross-org opt-out enforcement inappropriate for distinct business units.
Testing your ClickDimensions unsubscribe link
- Send a test message to a controlled Gmail address you own via the ClickDimensions campaign preview action
- Click the footer unsubscribe link and confirm the opt-out on the landing page
- Check the subscriber or contact record: the status should be Unsubscribed within seconds
- Verify the RFC 8058 headers in Gmail: open the message, click three dots, then Show original. Look for
List-UnsubscribeandList-Unsubscribe-Post: List-Unsubscribe=One-Click
Want the full 222-platform reference?
See the pillar guide with the compliance landscape, the RFC 8058 deep dive, and the unsubscribe tag for every ESP: How to add an unsubscribe link: the complete 2026 guide →
How to add the ClickDimensions unsubscribe link (step by step)
ClickDimensions default templates include the unsubscribe link in the footer, but custom HTML templates require the field inserted manually inside Dynamics 365.
- Open your email template in Dynamics 365 > ClickDimensions > Email templates.
- Add or edit a text block in the footer where the unsubscribe link should appear.
- Insert the merge field
{{unsubscribe_url}}. ClickDimensions replaces it at send time with a signed URL scoped to the Dynamics contact record. - Wrap it in an anchor:
<a href="{{unsubscribe_url}}">Unsubscribe</a>. - Verify the sender identity is configured under Dynamics 365 > ClickDimensions Settings.
- Send a test to a seed address and verify the rendered link routes to the ClickDimensions-hosted preference page and updates the Dynamics contact marketing opt-in flag.
Native Dynamics 365 integration and single source of truth
ClickDimensions native Dynamics 365 integration means the Dynamics contact record is the single source of truth for consent state. Dynamics-side updates to marketing opt-in flags flow to ClickDimensions automatically and vice versa. Enterprise customers running multiple Dynamics 365 organizations should configure per-org consent scoping to avoid cross-org opt-out enforcement inappropriate for distinct business units. All ClickDimensions data lives inside the Dynamics 365 database, so backup, GDPR export, and audit trail requirements are handled at the Dynamics level rather than a separate ESP database.
RFC 8058 one-click headers
ClickDimensions added RFC 8058 one-click unsubscribe automatically ahead of the Google and Yahoo February 2024 requirements. The List-Unsubscribe and List-Unsubscribe-Post headers inject on every marketing send from domains authenticated under Dynamics 365 > ClickDimensions Settings. SPF and DKIM records must be verified. Per-org authentication may be required in multi-org enterprise deployments where each Dynamics 365 organization has distinct sending domains.
Marketing automation and unified consent state
ClickDimensions marketing automation workflows respect the Dynamics contact opt-out flag at every send step. A contact who unsubscribes exits all workflows automatically. Dynamics workflow triggers can also enroll contacts in ClickDimensions campaigns based on CRM events (opportunity close, service case resolution), with automatic consent respect through the native integration. This unified consent state is essential for enterprise B2B running Dynamics as the central CRM across marketing, sales, and service.
Frequently Asked Questions
What is the ClickDimensions unsubscribe merge field?
The merge field is {{unsubscribe_url}}. ClickDimensions replaces it at send time with a signed URL scoped to the Dynamics contact record. Use it inside an anchor: <a href="{{unsubscribe_url}}">Unsubscribe</a>.
Does ClickDimensions sync opt-outs to Dynamics 365?
Yes natively. The Dynamics contact record is the single source of truth for consent state. Dynamics-side updates flow to ClickDimensions automatically and vice versa. No separate suppression list to maintain.
Does ClickDimensions support one-click unsubscribe for Gmail and Yahoo?
Yes, automatically for authenticated domains. ClickDimensions injects List-Unsubscribe and List-Unsubscribe-Post headers on every marketing send from domains verified under Dynamics 365 > ClickDimensions Settings.
Do multi-org Dynamics deployments share suppression?
Not by default. Configure per-org consent scoping to avoid cross-org opt-out enforcement inappropriate for distinct business units. Each Dynamics 365 organization maintains its own contact suppression state.
How does ClickDimensions compare to Dynamics Marketing?
ClickDimensions is a third-party solution deeply integrated into Dynamics 365. Microsoft s own Dynamics 365 Marketing (now Customer Insights – Journeys) is the first-party offering. Feature depth, licensing model, and implementation complexity differ; both serve Dynamics-centric enterprises.
About the Author
Alaa · LinkedIn
Email infrastructure specialist with 8+ years of hands-on experience in SMTP, deliverability, and email verification. I’ve configured and troubleshot mail systems across Postfix, Exchange, and cloud relays, managed IP reputation and warmup campaigns, and built verification pipelines processing millions of addresses. My work spans DNS authentication (SPF, DKIM, DMARC, BIMI), bounce handling, blocklist monitoring, and compliance frameworks including CAN-SPAM and GDPR. I write every article on SMTPedia to give email professionals, developers, and marketers the accurate, RFC-grounded reference they need.
About SMTPedia
SMTPedia is an independent email industry reference covering SMTP, IMAP, POP3, email deliverability, marketing platforms, DNS authentication, and email verification. Every article is researched from official provider documentation, IETF RFCs, and industry best practices. Settings and configurations are verified quarterly.
We are cited as a source by ChatGPT, Microsoft Copilot, and thousands of email professionals worldwide. Learn more about our editorial process.
