documentation/content/applications/marketing/email_marketing/unsubscriptions.rst
Sam Lieber (sali) 29d884c548 [ADD] email marketing: essentials, mailing lists, unsubscriptions
closes odoo/documentation#5385

X-original-commit: 56a291831a
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
2023-08-08 21:01:00 +02:00

75 lines
3.3 KiB
ReStructuredText

==================================
Manage unsubscriptions (Blacklist)
==================================
Providing recipients with the power to unsubscribe from mailing lists is not only a smart business
practice, it's often a legal requirement. By allowing recipients to unsubscribe from a mailing list
establishes a sense of trust with an audience, and helps companies appear genuine (and not spammy).
Enable the Blacklist feature
============================
First, the *Blacklist* feature must be enabled. To do that, navigate to :menuselection:`Email
Marketing app --> Configuration --> Settings`, enable to :guilabel:`Blacklist Options when
Unsubscribing`, and click :guilabel:`Save`.
.. image:: unsubscriptions/blacklist-feature.png
:align: center
:alt: View of the blacklist feature in the Settings page of the Odoo Email Marketing app.
With that feature activated, an *Unsubscribe* link appears in mailings. If a recipient clicks that
link, Odoo reveals a :guilabel:`Unsubscriptions` page, where they can directly manage their
subscriptions.
.. note::
With a test mailing, clicking the :guilabel:`Unsubscribe` link reveals an error page (*error 403
- Access Denied*). To make sure the link is working properly, create the mailing, and only send
it to a personal email.
Blacklist
=========
In addition to having the option to *Unsubscribe* from specific mailing lists, the recipient can
also *Blacklist* themselves, meaning they will not receive *any* more emails.
.. note::
The mailing list has to be configured as *Public* in order to be visible for users.
To view a complete collection of blacklisted email addresses, navigate to :menuselection:`Email
Marketing app --> Configuration --> Blacklisted Email Addresses`.
.. image:: unsubscriptions/blacklisted-email-addresses.png
:align: center
:alt: View of the blacklisted email addresses page in Odoo Email Marketing.
When a blacklisted record is selected from this page, Odoo reveals a separate page with that
blacklisted recipient's contact information.
.. image:: unsubscriptions/blacklisted-contact-form.png
:align: center
:alt: View of a blacklisted contact detail form in Odoo Email Marketing.
In the :guilabel:`Chatter` of this page, there's a time-stamped message, informing the user when
that recipient blacklisted themselves (via a :guilabel:`Mail Blacklist created` log note).
Unblacklist contacts
====================
To *Unblacklist* contacts, click the :guilabel:`Unblacklist` button in the upper-left corner to
remove the contact from the blacklist, allowing them to receive mailings once again.
When :guilabel:`Unblacklist` is clicked, a pop-up appears. In this pop-up, the specific email
address is listed, and there's a :guilabel:`Reason` field, in which a reason can be entered,
explaining why this particular contact was removed from the blacklist.
.. image:: unsubscriptions/unblacklist-popup.png
:align: center
:alt: View of the unblacklist pop-up window in the Odoo Email Marketing application.
After filling in the fields, click :guilabel:`Confirm` to officially remove that particular contact
from the blacklist.
.. seealso::
- :doc:`/applications/marketing/email_marketing`
- :doc:`/applications/marketing/email_marketing/mailing_lists`