• Skip to primary navigation
  • Skip to main content
  • Skip to primary sidebar
The Newsletter Plugin Documentation

The Newsletter Plugin Documentation

Every little detail discovered.

  • Premium
  • Support Ticket
  • Account
  • Blog

Lists

Newsletter has only one database made of unique email addresses. Each address corresponds to a subscriber and can be inserted in one or more lists. Lists are very useful to target subscribers when you send a newsletter or to associate special services (as, for example, the Automated Newsletters Extension).  Here we will cover all the essentials you need to know to get started. 

1. General information about subscription

Subscribers can be associated to one or more lists in different ways:

  • Subscribers can choose a list straight from the subscription form, if you configured one or more lists to be shown during subscription;
  • Manually, from the subscription configuration panel where a number of lists can be specified and can be assigned to every new subscriber (selected lists can be public or private);
  • Automatically, if you are using one of the provided shortcodes that generate a subscription form (for example [newsletter_form lists="1"]): thanks to the lists attribute, new subscribers can be inserted in default lists. Those lists must be public since the subscribers are added with hidden fields in the public subscription form (read more below);
  • Through the configuration of professional extensions (woocommerce, contact form 7, wp user registration…).

2. Private and Public lists

Newsletter divides lists in two macro categories: public lists and private lists.

Public lists allow users to control their preferences by selecting on which list they want to be subscribed either from the subscription form or by updating their personal profile. 

With public lists you can invent many combinations, for example:

  1. Force the activation of a public list during subscription (see below) but make it changeable on the profile editing panel;

  2. Show lists during the subscription process so the user can activate them (but the subscription form becomes more complex);

  3. Setting lists modifiable only on subscriber profile page to make the subscription form simpler and show the profile editing form on the welcome page, just after the subscribers confirm their subscription (inviting them to select what they want to receive). 

On the other side, private lists give to the administrator full control of the subscribers, as only the administrator can add or remore users from that list. This type of list can be used by the administrator as an internal classification method, and private lists are still available when targeting a newsletter.

For example, you can use private lists if have a premium newsletter and you want full control on the subscribers or if you want to target a special group of subscribers not allowing anyone to enter without your consent. 

There is also another option, which is kind of in between public and private lists: you can create a public list but decide not to show it on the subscription forms or in the user’s profile (in the previous versions of the plugin, this option was called “hidden list”).

3. Enforced lists and forms subscribing to a specific list

When a list is marked as “enforced”, every new subscriber is added to that list. This works either with private or public list.

How to put forms with “enforced” lists on different pages

If you have more than one subscription form on your site (with different purposes) you should assign the subscribers to different lists, so you can then distinguish the origin of subscribers and you can target them separately.

Let’s say for example that your site has some different sections: outdoor news and sport news. You should could create two lists (e.g. sport and outdoor), make them public lists and, for example, set the option “show on personal profile”. 

At this point, you can create two landing pages one asking to subscribe to the sport news and the other to the outdoor news and you can add to each page a subscription form with “enforced” lists, by using the following shortcodes:

[newsletter_form lists="x"]
[newsletter_form lists=“y”]

Where “x” and “y” are replaced by the reference number of each list (by default, you can have up to 40 lists). If you want to subscribe your user to both lists, just put them separated by a comma: [newsletter_form lists="x, y"]

Important note: Newsletter manages automatically double subscriptions and will update and merge the subscriber profile if a user subscribes on both landing pages. 

More on subscription in different lists:

  • Frictionless subscription flow and how to ask more details
  • Import subscribers and ask them to confirm
  • Subscription forms and lists

4. Best practices and tips 

When you send an email, you should ask yourself some questions: What’s inside for the subscriber? Is it something they are interested in? To make sure that you reach your goal, it may be worth to ask to the subscribers their own preferences. This operation will tell you exactly what to send. In fact, subscribers can use the lists to follow their interests and you can use those preferences to send targeted emails.

Let’s make some examples.

On a software product oriented blog, you could set up three preferences:

  1. product updates
  2. developer channel
  3. tutorial and use cases

To the users in list #1 you’ll send everything related to updates, bug fixes (ready to be installed), new features and so on.

To those in list #2 you’ll send technical information.  For those who use the product as developers, they should have technical skills to understand the content.

To users within list #3 you’ll send tips, tutorials and examples to get the best from your product.

When you need to promote something related to your product, for example a promo code or a complementary product, you can send an email to all those lists. It is not necessary to create a fourth list merging the first three. Or you can send the update only to a couple of list, for example lists #1 and #2. Newsletter will take care to merge the subscribers from both the lists. Visit the Targeting page and the Extra Profile Fields and Profile Fields Targeting page to find more information about this topic. 

Important notes 

  • Subscribers can modify their preferences on the profile edit page. On every message you should care to add this tag {profile_url} (which converts to a list on the profile page) inviting the receivers to modify their profile if needed. Read more about profile pages. 

  • Multilanguage. to understand the multilanguage setup (available when you use WPML or Polylang), please refer to the Newsletter multilanguage documentation page.

  • If you create a new list, you can simply mail your subscribers and invite them to activate that list on their profile page if they are interested. It is not necessary to create a different list or make them subscribe again. 

  • Retargeting. Lists can be used for retargeting. With the Reports Addon you can easily select a subset of targeted subscribers who opened or clicked your newsletter and put them in a temporary list to send a second email only to those interested users.

  • Set/unset lists. If you want to set or unset massively a list, you can easily do that by using the “massive action” page on the “subscribers management panel”, inside the Newsletter dashboard. On that page, you can perform a wide range of operations and also move users from one list to another.

  • More lists. Newsletter gives you by default the chance to have up to 40 lists. If you want more, you have to modify your wp-config.php, and you should add this code:
define('NEWSLETTER_LIST_MAX', X);

Where ‘x’ is the number of lists you want. To perform this operation, follow these steps:

  1. Deactivate the plugin
  2. Change the wp-config.php
  3. Reactivate the plugin.

No data will be lost and lists will be converted in database columns. You should avoid getting over 100 lists. 

Have you ever considered going premium?

With a premium plan, you'll get whole collection of 30+ professional addons, along with a full year of updates and priority support. No automatic renewals, frequent releases and a solid 30 days refund policy.

Go Premium Now!

Primary Sidebar

  • Installation
  • Getting Started
  • How to Install Addons
  • How to install the Addons Manager
  • Main Configuration
  • The Status Panel
  • Subscription
  • Subscription Basics
  • Lists
  • Spam Subscriptions
  • Subscription forms and shortcodes
  • Custom coded forms
  • GDPR compliancy
  • Subscribers and management
  • Profile page
  • Cancellation
  • Subscribers Statistics
  • Subscribers Management
  • Newsletters
  • Create and Send Newsletters
  • The Newsletter Composer
  • Targeting
  • Extra Profile Fields and Profile Fields Targeting
  • Tags
  • Multilanguage
  • Addons
  • Delivery Addons
  • Amazon SES Addon
  • SendGrid Addon
  • Sendinblue Addon
  • SparkPost Addon
  • ElasticEmail Addon
  • Mailgun Addon
  • MailJet Addon
  • Extended Features
  • Advanced Import
  • Automated
  • Autoresponder
  • Bounce Management
  • Geolocation Extension
  • Google Analytics Extension
  • Leads Extension
  • Locked Content
  • Reports and Retargeting
  • Archive
  • Speed Control
  • Subscribe on Comment
  • WP User Registration
  • Integrations
  • BuddyPress Integration
  • Contact Form 7 Integration
  • Event Manager Integration
  • Facebook Integration
  • Ninja Forms Integration
  • The Events Calendar Integration
  • Translatepress Integration
  • WooCommerce Integration
  • Easy Digital Downloads Integration
  • Elementor Forms Integration
  • WP Forms Integration
  • Instasend
  • Customization
  • Forms style
  • Message templates
  • Delivery and spam
  • Delivery Speed And The Cron Problem
  • Email Delivery Issues
  • The Spam Problem
  • Developers & Advanced Topics
  • Backup, Recovery, Delete
  • Composer Blocks
  • Constants
  • Filters and Actions
  • Incompatibilities
  • Newsletter API Version 2
  • Newsletter API version 1
  • Newsletter Legacy API