How to enable the mechanism unsubscribing recipients from the mailing list

To be in compliance with the email disclaimers international legislation and ensure that your Clients can unsubscribe from your mailing lists, CodeTwo Exchange Rules Pro lets you configure the program to add the particular recipients' email addresses to the blacklist yet block your corporate messages against reaching their mailboxes. The creation of such rules will include the unsubscribe link into emails sent from your company, which once clicked, triggers the unsubscribe mechanism that adds the particular recipient to the blacklist blocking your company's future messages from reaching that recipient's mailbox.

Getting started

To configure the program to enable your clients unsubscribing from the mailing list, you need to:

  1. Add the predefined Unsubscribe mechanism rule that will automatically insert the combination of two rules:
    • The first rule includes: the Block message action and two Recipient conditions bound with And logical relationship. By default, these conditions are configured in the following way: Recipient is external and Recipient belongs to the blacklist [name of the blacklist].
    • The second rule includes: the Insert disclaimer action with the {unsubscribe link} placeholder included in the template and the Recipient condition configured in the following way: Recipient is external.
  2. Make sure that the server where the Exchange Rules Pro Service resides, has the 8080 port opened for the outgoing connections.



The combination of rules in the ready-made Unsubscribe mechanism, provides one-click configuration of the program to enable your Clients unsubscribing from your company's mailing list. Therefore, it does not require any extra steps so you can enable it straight after adding in the program via the Submit changes button. However, if you want to personalize the ready-made disclaimer template including the {unsubscribe link} placeholder or define the senders to whom the rules will apply, go through the demonstration steps below.

On the List of rules pane in the Administration Panel, click Add and from the drop-down menu choose Unsubscribe mechanism (Fig. 1.).

Fig. 1. Adding the predefined combination of rules used by the unsubscribe mechanism.

This will add the predefined combination of two rules responsible for unsubscribing your recipients from the mailing list (Fig. 2.).

Fig. 2. The predefined combination of rules responsible for triggering the Unsubscribe mechanism.

The first rule: Unsubscribe mechanism - Block message, is used for blocking emails sent to the external recipients that belong to the particular blacklist. The configuration of this rule includes:

  • Recipient is external condition - this condition will be met if an email is sent to the recipient outside your organization.
  • Recipient belongs to blacklist [name of the blacklist] condition - this condition will be triggered if an email is sent to the recipient included in the selected blacklist.


    Note that the conditions above are bound with the And logical relationship (Fig. 3.) what means that they both need to be met for the rule to be triggered. It assures that only the recipients who are external and belong to the particular blacklist will be taken into account while triggering the rule yet applying the Block message action.

Fig. 3. Both Recipient conditions bound with And logical relationship.
  • Block message action - this action (Fig. 4.) blocks sending emails to the external recipient included in the defined blacklist.
Fig. 4. Block message action.

The second rule: Unsubscribe mechanism - unsubscribe link, is used for inserting disclaimer with the {unsubscribe link} included to emails sent to the external recipients. This rule involves the following configuration:

  • Recipient is external condition - this condition (Fig. 5.) is responsible for triggering the insertion of the disclaimer with the {unsubscribe link} to emails sent to the external recipients.
Fig. 5. Recipient is external condition.
  • Insert disclaimer action with the {unsubscribe link} included and configured (Fig. 6.) - this action inserts the disclaimer with the {unsubscribe link} to emails sent to the external recipients.
Fig. 6. Insert disclaimer action with the {unsubscribe link} placeholder included.


Note that the predefined combination of rules is based on the most common scenario and applies to all emails sent from your company to the external recipients. Furthermore, if the particular recipient is added to the blacklist, each email sent from your company will be blocked against reaching that recipient's inbox. However, you can define the conditions in any way you want. For example, if you want only the chosen email addresses or the specific departments to have their emails blocked for the recipients included in the blacklists, add the Sender condition to both rules with the default And logical relationship between the conditions and select the Sender type of your choice.

As the Insert disclaimer action has a predefined content of the disclaimer provided, including the configuration of the {unsubscribe link} placeholder, you can adjust it by editing the template. On the Actions tab, click Edit to enter the Editor (Fig. 7.).

Fig. 7. Opening the Editor.

Within the content area define your disclaimer's text and reconfigure the {unsubscribe link} placeholder. To reconfigure the {unsubscribe placeholder}, right-click it and from the context menu choose Placeholder properties (Fig. 8.). The window that opens, lets you define the blacklist to which the email address of the recipient will be added after clicking the unsubscribe link, enter the link's display text and decide what landing page should be opened after hitting the unsubscribe link in the received email: either the default web page provided by CodeTwo or a third-party web page of your choice.

Fig. 8. Adjusting the content of the disclaimer.

If you decide to adjust the disclaimer, once you finish editing it, click the Save button and close the Editor (Fig. 9.).

Fig. 9. Saving the disclaimer template with the Unsubscribe link placeholder.

Next, save your changes in the Administration Panel and you're ready to go (Fig. 10.).

Fig. 10. Saving the Unsubscribe mechanism rules in the Administration Panel.

From now on, each email sent from your company will include the unsubscribe link (Fig. 11.) which, if clicked, opens the unsubscribe landing page (Fig. 12.) and blocks any further emails coming from your company or the specific email addresses/departments against reaching the particular recipient's inbox.

Exchange Rules Pro - unsubscribe link message
Fig. 11. The received message including the unsubscribe link.
Exchange Rules Pro - unsubscribe link confirmation
Fig. 12. The unsubscribe mechanism's landing page.


Note that the recipients who click the unsubscribe link will be automatically added to the blacklist specified in Fig. 8. above. Furthermore, you can view and manage the blacklists (add or remove) and the recipients (add, remove or edit) at any point (before or after enabling the unsubscribe mechanism) via the Recipients blacklist (Fig. 13.) tab in Settings located in the Administration Panel's ribbon.

Fig. 13. Managing the blacklists and recipients included in the blacklists.

Was this information useful?