# Newsletters

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Getting started

In this article, you can find information about the newsletter functionality, which allows customers to register to a newsletter list, which can be sent to third-party applications via API, like Bloomreach. It is possible to create newsletter groups to categorize types of customers.

Table of contents:

1. [ Functionality configuration](#bkmrk-functionality-config-1)
2. [ Registration for the newsletter subscription](#bkmrk-registration-for-the)
    1. [Logged-out customers](#bkmrk-logged-out-customers)
    2. [During registration](#bkmrk-during-registration)
    3. [Logged-in customers](#bkmrk-logged-in-customers)
3. [ Managing subscribers](#bkmrk-managing-subscribers)
4. [ Managing subscriber groups](#bkmrk-managing-subscriber-)
5. [ Subscribers import](#bkmrk-subscribers-import)
6. [ Subscribers export](#bkmrk-subscribers-export)

---

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Functionality configuration

To enable the customers to register for the newsletter on the website it needs to be first enabled in the system settings. Newsletter configuration can be found in:

***System > System / Settings > Built-in Functions > Newsletter***

<table id="bkmrk-visualization-of-the" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">[![POWERPNT_cSyQIf1rwf.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/powerpnt-csyqif1rwf.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/powerpnt-csyqif1rwf.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the newsletter functionality system settings* </span></td></tr></tbody></table>

In the Newsletter section you can find three switches:

- **Enabled** - Switch which enables / disables the functionality and the ability to use it by   
    the customers.
- <label class="control-label" for="settings_nlt_3rd_party_agreements_enabled">**Show 3rd party agreement checkbox** - Switch defining if the 3rd party newsletter agreement should be visible while registering a new account instead of a built-in agreement. This option requires properly configuring the agreement on a 3rd party platform.  
    </label>
- <label class="control-label" for="settings_newsletter_double_opt_in">**Double activation** - A switch defining whether unregistered customers should confirm the newsletter subscription in a separate e-mail, before signing them in.</label>

Additionally, the title of the newsletter confirmation e-mail can be changed in the

***System &gt; System / Settings &gt; General &gt; E-mails***

<table id="bkmrk-visualization-of-the-1" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">[![POWERPNT_k0wPPET2Fh.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/powerpnt-k0wppet2fh.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/powerpnt-k0wppet2fh.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the E-mails tab in the System / Settings* </span></td></tr></tbody></table>

---

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Registration for the newsletter subscription

## Logged-out customers

Customers who do not have an account on the e-commerce platform, or are not logged in are able to register for the newsletter using the /newsletter webpage. Usually, the /newsletter webpage is linked in the e-commerce platform footer, but that depends on your individual needs.

<table id="bkmrk-visualization-of-the-2" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">![POWERPNT_dgZ9rV298A.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075808199068.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the /newsletter page* </span></td></tr></tbody></table>

On the /newsletter webpage customers are able to type their e-mail address and their additional information, and register for the newsletters. When the <label class="control-label" for="settings_newsletter_double_opt_in">**Double activation**</label> is activated in the [System / Settings](#bkmrk-functionality-config-1) customers will receive an e-mail confirmation if they want to register for a newsletter. If this functionality is disabled, the customers will instantly join the newsletter list. Customers are unable to cancel their subscription from this page - it has to be done using the URL in the newsletter or from the customer panel described in [Logged-in customers.](#bkmrk-logged-in-customers)

## During registration

During the registration process, when the customer selects the agreement, that they agree to an e-mail communication they will sign in to the newsletter list.

<table id="bkmrk-visualization-of-the-3" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">![Screenshot 2023-11-03 at 12-18-15 CZ UAT - Yves Rocher internetový prodej kosmetických výrobků na obličej a tělo parfémů a líčení. Kosmetika Yves Rocher pro přírodní krásu.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11123139302172.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the registration form* </span></td></tr></tbody></table>

Same as for [logged-out customers](#bkmrk-logged-out-customers) when the <label class="control-label" for="settings_newsletter_double_opt_in">**Double activation**</label> is activated in the [System / Settings](#bkmrk-functionality-config-1) customers will receive an e-mail confirmation if they want to register for a newsletter. If this functionality is disabled, the customers will instantly join the newsletter list. Customers are able to cancel their subscription using the URL in the newsletter or from the customer panel described in [Logged-in customers.](#bkmrk-logged-in-customers)

## Logged-in customers

Registered and logged-in customers are able to register to the newsletter functionality in their customer panel by accessing the /customer/newsletter option. Logged-in customers will also get redirected to this webpage when they access the previously mentioned /newsletter URL.

<table id="bkmrk-visualization-of-the-4" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">![POWERPNT_gG2zTq5AAt.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075776927132.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the /customer/newsletter page* </span></td></tr></tbody></table>

In the /customer/newsletter webpage customer only has to fill in their e-mail address and are able to register to the newsletter list. Customers registering to the newsletters this way do not have to accept the newsletter registration even if the **Double activation** is enabled.

<table id="bkmrk-visualization-of-the-5" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">![POWERPNT_r8BWDzSDTC.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11075808228380.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the /customer/newsletter page* </span></td></tr></tbody></table>

When the customer is logged-in and registered to a newsletter functionality they are able to cancel their subscription from the /customer/newsletter webpage.

---

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Managing subscribers

All customers that are registered for a newsletter functionality, or have canceled their subscription can be found in the admin panel. Subscribers list is located in the:

***Customers &gt; Subscribers / list***

This tab contains filters, which will help manage the desired customers

<table id="bkmrk-visualization-of-the-6" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">[![POWERPNT_5bTOkGepbI.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/powerpnt-5btokgepbi.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/powerpnt-5btokgepbi.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the Subscribers / list filters* </span></td></tr></tbody></table>

There are the following filters available:

- Creation time - A time range when the subscribers were created
- Update time - A time range when the subscribers were last updated
- Show MD5 e-mail hash column - Adds a new column that contains MD5 e-mail hash

<table id="bkmrk-visualization-of-the-7" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">[![POWERPNT_vUioNu6ifn.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/powerpnt-vuionu6ifn.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/powerpnt-vuionu6ifn.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the Subscribers list tab* </span></td></tr></tbody></table>

In the subscriber list table you can find the following options:

- **<span style="color: #4054a0;">(1)</span>**<span style="color: #4054a0;"> </span>**Show X Entries** allows to filter how many entries should be visible at once
- **<span style="color: #4054a0;">(2)</span>** Various table columns. All of them can be sorted by clicking on them. 
    - **ID** - Subscribers internal ID
    - **First/last name** - Subscribers first and last name
    - **E-mail** - Subscribers e-mail address
    - **Status** - Subscribers status. Available statuses are **Active** and **Blacklisted**. Blacklisted customer unsubscribed to the newsletter, or was manually blacklisted, and won't receive receive newsletter e-mails.
    - **Creation time** - A date and hour when the customer has subscribed to a newsletter.
    - **Actions** - Two available actions: 
        - **Edit** - Allows to edit the selected customer. More about adding and editing the customer can be found below
        - **View** - View the selected subscriber. Viewing doesn't allow to edit any data.
- **<span style="color: #4054a0;">(3) </span>Add** button allows to manually add a new subscriber. Adding and editing a subscriber looks exactly the same. Below you can find more information about the available fields, when adding or editing a new customer.
- **<span style="color: #4054a0;">(4) </span>Search** field allows to search the subscribers by their name / surname as well as their e-mail address.
- **<span style="color: #4054a0;">(5)</span> Pages list** allows to show the next batch of customers on the another pages accoriding to applied sorting option and filters.

<table id="bkmrk-visualization-of-the-8" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">[![POWERPNT_9eNdWr9sE9.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/powerpnt-9endwr9se9.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/powerpnt-9endwr9se9.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the customer in the subscribers / list*</span>

</td></tr></tbody></table>

When editing or adding a new customer you can find there the following fields:

- **Customer** - A button that redirects to customers e-commerce profile. This option is only available if both subscriber e-mail and e-commerce account e-mail are the same.
- **E-mail** - Subscribers e-mail address. This field is mandatory.
- **Subscriber's groups** - Groups that the subscriber is assigned to. You can find more about the subscriber groups in the [ Managing subscriber groups](#bkmrk-managing-subscriber-) chapter.
- **First name** - Customers first name
- **Last name** - Customers last name
- **Gender** - Customers gender
- **Birthday** - Customers birthday date
- **Active** - A switch that defines if the subscriber is active or not. Not active subscribers won't receive any newsletters.
- **Is blacklisted?** - A switch, which defines if the subscriber is blacklisted. Blacklisted subscribers won't receive any newsletters.

Additionally, all agreements the subscriber has agreed on will be visible at the bottom of the page.

---

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Managing subscriber groups

Subscribers can be put in subscriber groups, which allows to easily manage them, and send a desire newsletters to a certain selected group. Subscriber groups can be manged in

***Customers &gt; Subscribers groups***

<table id="bkmrk-visualization-of-the-9" style="margin-right: auto; margin-left: auto; height: 44px; width: 699px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 687px;">[![POWERPNT_1KsQjyM0ac.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/powerpnt-1ksqjym0ac.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/powerpnt-1ksqjym0ac.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 687px;"><span class="wysiwyg-font-size-medium">*Visualization of the filters in subscribers groups.*</span>

</td></tr></tbody></table>

Subscribers groups filters allow to filter by **is active?** flag, which defines if the selected group is set as active or not.

<table id="bkmrk-visualization-of-the-10" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">[![POWERPNT_oYZO0ZtbPY.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/powerpnt-oyzo0ztbpy.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/powerpnt-oyzo0ztbpy.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the subscribers groups*</span>

</td></tr></tbody></table>

In the subscribers groups table you can find the following options:

- **<span style="color: #4054a0;">(1)</span>**<span style="color: #4054a0;"> </span>**Show X Entries** allows to filter how many entries should be visible at once
- **<span style="color: #4054a0;">(2)</span>** Various table columns. All of them can be sorted by clicking on them. 
    - **ID** - Subscriber group internal ID
    - **Name** - Internal name of a subscriber group.
    - **Description** - Short description of a subscriber group.
    - **Is active?** - Subscriber group activity status.
    - **Actions**  
        
        - **Edit** - Allows to edit the selected subscriber group. More about adding and editing the customer can be found below
- **<span style="color: #4054a0;">(3) </span>Add** button allows to addition of a new subscriber group. Adding and editing a subscriber looks exactly the same. Below you can find more information about the available fields, when adding or editing a new group.
- **<span style="color: #4054a0;">(4) </span>Search** field allows to search the subscribers groups by their name.
- **<span style="color: #4054a0;">(5)</span> Pages list** allows to show the next batch of groups on the another pages accoriding to applied sorting option and filters.

<table id="bkmrk-visualization-of-the-11" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">[![POWERPNT_xB6mE7vLoT.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/powerpnt-xb6me7vlot.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/powerpnt-xb6me7vlot.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the subscriber group creation*</span>

</td></tr></tbody></table>

In the subscriber group creation / edition you can define the following fields:

- **Name (mandatory)** - An internal name of a subscriber group.
- **Description** - Internal description of a subscriber group.
- **Is active?** - An activity flag, which defines if the selected group is active for use.

---

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Subscribers import

Subscribers can be imported using the import functionality located in

***Import / Export &gt; Import***

<table id="bkmrk-visualization-of-the-12" style="margin-right: auto; margin-left: auto; height: 44px; width: auto;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;">[![POWERPNT_gqVrv6nWxb.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/powerpnt-gqvrv6nwxb.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/powerpnt-gqvrv6nwxb.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: auto;"><span class="wysiwyg-font-size-medium">*Visualization of the subscribers import*</span>

</td></tr></tbody></table>

In order to import subscribers you have to select the "Newsletter subscribers CSV" option and select the prepared .csv file.

<table id="bkmrk-visualization-of-the-13" style="margin-right: auto; margin-left: auto; height: 44px; width: 699px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 687px;">![POWERPNT_GfKViKPmyb.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11123014341532.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 687px;"><span class="wysiwyg-font-size-medium">*Visualization of the subscribers csv file*</span>

</td></tr></tbody></table>

Subscribers .csv file can have any file name and must contain the following columns:

- **email (mandatory)** - Customers e-mail address.
- **Gender** - Customers gender. Accepted values are **M** for males and **F** for females.
- **Group** - Subscriber group internal name. This field will assign the selected customer to a selected subscriber group.
- **first\_name** - Customers first name
- **last\_name** - Customers last name
- **birthday** - Customers birthday in DD/MM/YYYY format.

---

# ![Screenshot_2020-04-29_at_19.12.41.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11062321618076.png) Subscribers export

Subscriber lists can be exported using the:

***Import / Export &gt; Export / Subscribers***

<table id="bkmrk-visualization-of-the-14" style="margin-right: auto; margin-left: auto; height: 44px; width: 699px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 687px;">[![POWERPNT_xB6mE7vLoT.png](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/scaled-1680-/armpowerpnt-xb6me7vlot.png)](https://ecomm-docs.tauceti-digital.com/uploads/images/gallery/2025-02/armpowerpnt-xb6me7vlot.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 687px;"><span class="wysiwyg-font-size-medium">*Visualization of the subscribers csv file*</span>

</td></tr></tbody></table>

In the Export / Customers you can filter out desirable data by using the selected filters:

- **Groups** - A list of selectable subscriber groups that should be exported.
- **Creation time** - A range of dates whenever the subscriber was created.
- **Update time** - A range of dates whenever the subscriber was updated.
- **Show MD5 e-mail hash column** - Adds the MD5 e-mail hash column in the exported file.

By pressing the "**Export**" button the file will be exported with the selected filters.

<table id="bkmrk-visualization-of-the-15" style="margin-right: auto; margin-left: auto; height: 43px; width: 699px;"><tbody><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 22px; width: 687px;">![POWERPNT_CA29rH5hz4.png](https://knowledge.tauceti-digital.com/uploads/images/gallery/2024-11/11123044812316.png)</td></tr><tr style="height: 22px;"><td class="wysiwyg-text-align-center" style="text-align: center; vertical-align: middle; height: 21px; width: 687px;"><span class="wysiwyg-font-size-medium">*Visualization of the exported subscribers file*</span>

</td></tr></tbody></table>

In the exported subscribers file you can find the following columns:

- **ID** - Subscriber internal ID.
- **First\_name** - Customers first name.
- **Last\_name** - Customers last name.
- **Email** - Subscribers e-mail address.
- **is\_active** - Activity status of a subscriber. 1 means active, 0 means not active.
- **is\_blacklisted** - blacklisted status of a subscriber. 1 is blacklisted, 0 is not blacklisted.
- **Gender** - Customers gender. M is for Male, F is for Female.
- **Status** - Subscribers status. Available statuses are: 
    - **Only newsletter** - Customer is only registered to the newsletter communication and doesn't have an account on a e-commerce platform.
    - **Customer** - The customer has a created account on an e-commerce platform
- **Mc\_hash** - MD5 e-mail hash. This field is only visible if the **Show MD5 e-mail hash column** filter was selected.
- **Joy\_id** - Customers JOY ID.
- **Birthday** - Customers birthday date.
- **Subscribe time** - A date with an hour when the customer has subscribed to an   
    e-mail communication.