The Newsletter plugin allows you to create subscription forms and send newsletters to your subscribers. In this tutorial, we provide detailed instructions on how to use the Newsletter plugin to create language-based subscription forms, lists, and newsletters using WPML.

Content

Getting started

If you are a website owner working with a developer, please ask the developer to review these settings for you.
If you are a developer, ensure that the Newsletter plugin is activated by navigating to the Plugins -> Installed Plugins page.
In addition, ensure that the WPML Multilingual CMS, WPML String Translation, WPML Translation Management, and WPML Media Translation plugins are activated.

Creating and translating subscriber lists

As you are running a multilingual website, you must create a subscription list for each language. This facilitates the process of creating and sending language-based newsletters to your subscribers. In our example, we have a multilingual website that uses English as the default language and Spanish as the secondary language. We will create lists that will be pre-assigned to our subscribers by language.

  1. Ensure that the admin bar language switcher is set to All Languages.
  2. Navigate to Newsletter -> List Building -> Lists.
  3. Navigate to the lists screen
  4. Name each language-list and choose languages for “Pre-assigned by language.
  5. Add the language list names and choose the language

If you are running a multilingual website with more than two languages, you can create lists for other languages by following the exact same steps above. Now that we have our language-based subscription lists set up, let’s see how we can create our subscription forms.

Creating subscription forms

To edit the subscription form field labels under the default language (English), make sure that the admin bar language switcher is set to English and navigate to Newsletter -> List Building -> Subscription Form Fields, Buttons, Labels.

Navigate to the form field labels screen

There, you can edit all the field labels, error messages, and the subscription button texts for the default language. Once done, don’t forget to save your changes.

From fields labels

Translating the form fields labels

To translate the subscription form field labels, use the admin bar language switcher to choose the language you want to translate your field labels into, then add the translated fields labels and Save.

Add the secondary language translated text to the field labels and Save

Displaying the subscription form on the front-end

You can display the subscription form on a dedicated page on your website using the [newsletter] shortcode or add a newsletter widget to your sidebar.

Let’s see how the dedicated subscription page looks on the front-end:

Default language subscription form page

To translate this page, follow the steps below:

  1. Navigate to the Pages Screen and click on the + icon to translate the subscription form page into the desired language. This takes you to the Translation Editor screen.
  2. Click on the + icon to translate the subscription form page
  3. Translate all the textual elements on the page and make sure that the [newsletter] shortcode is the same as in the default language. WPML will automatically load the translated version of the form on the front-end. Tick the “Translation is complete” checkbox for all the fields and Save & Close.
  4. Add the translated text and preserve the newsletter shortcode

This is how the translated subscription form page looks on the front-end:

Translated subscription form page on the front-end

You can add the subscription form as a widget on your sidebar or footer by navigating to Appearance -> Widgets then dragging and dropping the newsletter widget to your preferred widget area. Set the Display on language drop-down menu to All Languages and Save.

Add the newsletter widget to your widget area of of choice

To translate the newsletter widget title and other widget texts, check our detailed guide on translating widgets.

WPML automatically loads the translated newsletter widget texts on the translated version of the website. Here is how the newsletter widget looks on the front-end:

Newsletter widget on the front-end

Users subscribing to different language versions of the form

When a user subscribes to the newsletter through the English form, their contact information will be added to the English list that we created earlier. The same applies to users subscribing to other language versions of the form.

For example, we have a user who subscribed through the English version of the form and another through the Spanish version of the form. You can ensure that each user is pre-assigned to the correct language list by following the steps below:

  1. Navigate to Newsletters -> Subscribers.
  2. Click on the Edit button for the English user.
  3. Click on the Edit button of the English user
  4. Click on the Lists tab. You can see that the user is pre-assigned to the English list.
  5. English user pre-assigned to the English list
  6. The same applies to the Spanish user.

Creating and translating service messages and emails (welcome, activation, cancellation)

The Newsletter plugin displays messages to the users and sends emails upon different actions, such as activation and cancellation messages and emails.

To update the text of the welcome and activation messages and emails under the default language, follow the steps below:

  1. Use the admin bar language switcher to choose your default language.
  2. Navigate to Newsletter -> List Building.
  3. You will see three tabs (Subscription, Welcome, Activation). These tabs include the messages that are displayed and the emails sent to the user. For example, if you want to update the welcome message and email, click on the Welcome tab.
  4. Update the default language service messages and save
  5. Update the text and Save.

You can follow the same steps to update the default language subscription and activation messages and emails. You can update the wording of the cancellation and reactivation messages and emails by navigating to Newsletter -> List Building -> Unsubscription.

Default language cancellation and reactivation messages and emails

To translate the different service messages, follow the steps below:

  1. Navigate to the message email editing screen. For example, if we want to translate the welcome message and email, navigate to Newsletter -> List Building and click on the Welcome tab.
  2. Choose the language you want to translate the welcome message and email into using the admin bar language switcher. In our example, it is Spanish.
  3. Add your translated text and save.
  4. Translate the service messages and emails

This is how the translated welcome messages is displayed on the front-end:

Translated welcome message on the front-end

Follow the same steps above to translate other service messages and emails.

Creating and translating the subscriber profile page

Users can update their subscription information through the subscriber profile page. You can add the {profile_url} tag to any of the emails you send to the subscribers including the welcome and activation emails. This tag adds a link that drives the subscriber to a profile editing page.

To update the default language profile page, follow the steps below:

  1. Navigate to Newsletter -> Dashboard then hover over the Subscribers tab and click on Profile page.
  2. Ensure that the admin bar language switcher has the default language active. In our example it is English.
  3. Navigate to the profile page on the back-end
  4. Update the profile page text, messages, and labels, then Save.
  5. Update the default language profile page text

This is how the default language subscriber profile page looks on the front-end:

Default language subscriber profile page – front end

To translate the subscriber profile page, simply use the admin bar language switcher to choose the language you want to translate your subscriber profile page into, add the translated text, and Save.

Translating the subscriber profile page text

This is how the secondary language subscriber profile page looks on the front-end:

Secondary language subscriber profile page on the front-end

Sending language-based newsletters

To send newsletters to clients based on the subscription form language version they used, you must create a new newsletter for each language and send it to the corresponding language list. Follow the steps below to prepare and send a newsletter to your English subscribers:

  1. Navigate to Newsletter -> Newsletters then click on the New newsletter button.
  2. Create a new newsletter for the default language
  3. Select the newsletter theme. For demonstration purposes, we will choose the Blank theme.
  4. Select the newsletter theme
  5. Use the different modules to create your newsletter.
  6. Create the default language newsletter by adding modules
    Select the blog posts language
  7. Once you have finished composing your newsletter, click on the Save & Preview button.
  8. Click Save & Preview
  9. Add your subject line.
  10. Add the subject line
  11. Navigate to the Targeting tab and choose the corresponding language. In our example it is English.
  12. Choose the language list
  13. Set the other sending options to your liking and Send.

Repeat the steps above to create the translated versions of the newsletter in other languages. Make sure that you select the right language list.

Translating texts from the Newsletter plugin

In addition to contents that come from posts and pages on your site, there are usually some texts that come from other places. The most common examples are themes and plugins.

To learn how to translate these texts, read our documentation page about translating strings.

Getting help from our support team

We have supporters in our forum who are ready six days a week to help you. They are trained to use WPML with the Newsletter plugin.

If you are working with a developer for your site, please use our Translation support forum to get help with translating your site’s content.

If you are setting up the site and WPML yourself, please use our Technical support forum.