How to Add an Unsubscribe Header to Outgoing Emails (Dynamics & Exchange)
Question details
The user needs to configure a compliant unsubscribe header for outgoing commercial emails to meet sender requirements and improve email deliverability.

- Product
- Dynamics 365 Customer Insights and Exchange Online
- Device & OS
- not provided
- Scenario
- Setting up bulk or commercial email campaigns that require native, compliant one-click unsubscribe functionality.
- Observed behavior
- Outgoing commercial emails currently lack the necessary List-Unsubscribe headers, which need to be automatically injected via service settings or mail flow rules.
Ensure you have administrator access to either your Dynamics 365 Customer Insights environment or the Exchange Admin Center, depending on which service you use to send emails.
Enable One-Click Unsubscribe in Dynamics 365 Customer Insights
Use the built-in feature switches in Dynamics 365 (December 2023 release or later) to automatically insert compliant unsubscribe headers in commercial emails.
Dynamics 365 Customer Insights - Journeys includes native support for one-click unsubscribe headers, eliminating the need for manual configuration of message properties.
Log in to Dynamics 365 Customer Insights - Journeys and navigate to Settings > Other settings > Feature switches.
Locate the 'One-click unsubscribe' option in the list and toggle the switch to enable it.
Click save to apply the new configuration to your commercial emails.

Create a Mail Flow Rule in Exchange Online
If you are using Exchange Online, administrators can manually configure a List-Unsubscribe header for specific outgoing messages using mail flow rules.
Draft Your Email Campaigns with WPS Office
While managing technical email compliance policies in Exchange or Dynamics, you also need an efficient and cost-effective office suite to draft your newsletters, campaign reports, and marketing copy. WPS Office provides a free, lightweight, and highly compatible alternative to Microsoft Office.
- 1. Download WPS Office: Visit the official WPS Office website to download the free, lightweight installation package.
- 2. Install the Suite: Run the installer on your computer to quickly set up the office suite.
- 3. Draft Your Content: Open WPS Writer to seamlessly draft and format your email newsletters and marketing copy before importing them to your email client.

Frequently Asked Questions
Why is a List-Unsubscribe header important for commercial emails?
The List-Unsubscribe header is an anti-spam standard that allows email providers like Gmail or Yahoo to display a native, one-click unsubscribe button at the top of the email. This improves deliverability, reduces spam complaints, and ensures compliance with modern sender guidelines.
Can I use Exchange Online mail flow rules for large bulk marketing campaigns?
While you can technically set a List-Unsubscribe header via Exchange mail flow rules, it is strongly recommended to use a dedicated email marketing service for large bulk campaigns. Dedicated services ensure compliant, automated, and scalable unsubscribe processing that manual rules cannot provide.
Does the Dynamics 365 one-click unsubscribe feature work immediately?
No, after enabling the one-click unsubscribe feature switch in Dynamics 365 Customer Insights - Journeys, it can take up to 30 minutes for the changes to fully propagate and for the headers to be added to outgoing emails.




