Hide subscription form on the public page. Do not show the subscription form on the public page. You can set a custom content for that page on Subscription/Settings. At least a space is required, an empty content forces the system to fall back to the default value. You can add an image or few word explaining that is a service page.
How to change the form field names. How to change the subscription button label. All field labels and the submit button label can be set on the Subscription/Form configuration page. If you use the [newsletter_form] shortcode you can even specify some custom labels for the specific form.
Subscription form extra fields. Subscription form custom fields.
To show in the subscription form the custom fields you defined, you can simply configure the main form by selecting which fields you want to make available. If you use the [newsletter_form] shortcode you can even specify some custom labels for the specific form.
What is the activation page? How can I change the activation page content? Activation page. Customize the activation page.
The activation page is the message shown to the subscriber when he needs to check the email and confirm the subscription by clicking the activation URL. That message is shown when you use the double opt-in. The activation message shown to the subscriber can be changed on the Subscription/Settings administration page and it is shown on the Newsletter’s public page when needed. You can even select a specific WordPress page if you need to a really custom content with its own layout, title, and so on.
“Registration failed” message on subscription. The message “registration failed” is shown when a blocking condition is met and the subscription cannot continue. The error could be related to spam detection, the subscriber already registered and repeated registrations disabled (on the Subscription/Settings page) or the subscriber already registered but with a status that blocks a second registration (for example the bounce or complained status).
To know the exact reason, log in as administrator and repeat the registration: an explicative message should be shown.
How can I change the opt-in mode (double opt-in or DOI and single opt-in)? The Newsletter plugin supports single opt-in and double opt-in (DOI). They can be set on the Subscription/Settings page.
Shortcode. Subscription minimal form. Are there shortcodes to build custom subscription forms? Yes, the main shortcode that outputs a subscription form is [newsletter_form] and it has several attributes to change its behavior and layout. For example, to show a minimal form the syntax [newsletter_form type="minimal"] could be used. To control the form at the field level, the shortcode [newsletter_form_field] can be used. Read everything you need to know about the subscription form and field shortcodes.
How can I add a subscription form on the site footer widget area? If your theme supports the footer widget, you can use the Newsletter plugin widget. An alternative is to use a “shortcode” widget and use the [newsletter_form] shortcode. That shortcode has many attributes you can find here.
Can I create two subscription forms to add subscribers to different lists? Yes, you can create/publish two or more subscription forms connected to different lists. You can simply use the [newsletter_form] shortcode specifying the list number: [newsletter_form lists="2"]. You can even specify more than one list to be connected to a form: [newsletter_form lists="2, 4"]. All details are available on the subscription form shortcode page.
This technique is particularly useful for creating different landing pages to get subscribers and group them on different lists.
How can I add the subscription form to a post, article, or page? The simplest option is to use the [newsletter_form] shortcode and you can customize the fields and appearance with its attributes. An alternative is to use the Newsletter Gutenberg block if you create your content using Gutenberg.
Can I automatically add all new subscribers to a list? Yes, when you configure a list you can set it to be “preset” so every new subscriber will be added automatically to that list. If you have a multilanguage plugin (we support WPML and Polylang) you can set a list to be added automatically per language.
How can I change the “email confirmation required” message? The confirmation or activation message can be changed on the Subscription/Messages panel.
How can I change the activation email? Where can I change the confirmation email? How can I configure the activation email? The activation email can be configured on the Subscription/Settings page. Differently from the welcome email, it can not be designed with the composer (that could have been changed, anyway, check the Subscription/Settings page, Activation tab).
How can I change the welcome message? The welcome message can be changed on the Subscription/Messages or Subscription/Welcome email panels. You can choose between a simple message or a richer email created with the composer.
Can I receive a notification for each new subscription? Yes, you can set an email address in the Subscription/Settings page to which a simple notification is sent with a summary of the subscriber’s data. The notification is sent only when the subscriber confirms the subscription (if you use the single opt-in it is sent immediately).
Popup. How can I show a subscription popup?
A subscription popup can be activated and configured from the Subscription/Forms page. A few elements can be configured, for more features, you can use the Leads addon.
Captcha. Can I add a captcha or Google Recaptcha to subscription forms? How to avoid spambots. How to avoid spam subscriptions.
A simple captcha can be enabled as a second step during the subscription process in our Subscription/Antispam panel: it is usually less invasive than having a captcha in the subscription form. We do not support the Google Recaptcha. You can use a form builder (like Gravity Forms, Fluent Forms, WP Forms, and so on) and connect those forms with the Newsletter subscription using one of the integration addons.
In the antispam configuration, there are many other options to block spam.
Can I use the subscription form on a different site than the one where the plugin is installed? Yes, you can copy the HTML of the form and add it on another site. A working HTML can be found on the Subscription/Forms/HTML Forms page. It can be adjusted but the form “action” and the input field name attribute are preserved.
Can I install the Newsletter plugin on a secondary/dedicated site and collect subscriptions from the primary site? Yes, just use the subscription form you can get from the secondary site (for example using the HTML code you can find on the Subscription/Forms/HTML Forms page) and publish it on the primary site. It’s a good choice to make the primary site lighter and resource-saving. The secondary site becomes a mail marketing platform.
Welcome email. Where can I configure the welcome email?
The welcome email can be configured on the Subscription settings. You can just change the standard welcome email text or design a custom welcome email with the composer (recommended to have a much more engaging welcome email).
Can I add a coupon or discount code to the welcome email? The Newsletter plugin does not generate coupon codes BUT if you have a plugin that generates them, for example with the use of a shortcode, you can use that shortcode inside the welcome email body. An alternative is to be able to write the code that generates a discount code and use the newsletter_message filter to replace a custom tag, like {coupon}. See here some examples.
The same method can be used on a regular newsletter to send the coupon to all your subscribers (or a subset of them).
How can I get notified of new subscriptions via email? Notification of new subscriptions and new subscribers. Can I set multiple addresses to be notified of new subscriptions? To get a notification for each subscription you can set one email address to be notified on the Subscription/Settings page. The notification is sent only when the subscription is confirmed when you have the double opt-in active. Only one email address can be notified, multiple addresses are not supported: a workaround is to set an email address as an alias address that forwards the notification to the connected addresses. You should ask your email provider if it supports aliases and forwarding to multiple addresses.
Unsubscription
The unsubscription link does not work. The unsubscribe link is not working. The unsubscription shows the home page. The unsubscribe works but shows the subscription form or the wrong content. The unsubscribe link on my newsletters leads to the subscription page.
1) The unsubscribe link generated by the tag {unsubscription_url}, for example, the “footer” block when added to newsletters, works ONLY inside newsletters and when they’re sent to a real subscriber. The link should work if you send a test to your test subscriber. If you send a test to a free email address, the link does not work (since the receiver is not a real subscriber).
2) If the link brings you to the home page and the subscriber is not unsubscribed, it’s probably a cache problem: on the Newsletter’s main settings change the “tracking and action links” to the alternative format, send again a test newsletter and retry.
3) If the link unsubscribes the subscriber but then shows up on the wrong page, please check on the Newsletter’s main setting which page has been set as “public page”: it should be a page with only the [newsletter] shortcode inside.
4) If the link unsubscribes the subscriber but then shows the wrong content or the subscription form, editor the Newsletter public page and be sure it contains only the [newsletter] shortcode. To find the public page, go to your blog pages panel and identify the one with the note “Newsletter public page”.
Which is the unsubscribe shortcode? Can I show an unsubscribe form? Can I create an unsubscription page? No, there is not a shortcode to show an unsubscription form. To unsubscribe a subscriber needs to click on the personal link you provide in your newsletter (for example adding the recommended “footer” block). The unsubscription page is shown where the subscriber can confirm the opt-out.
How can I change the goodbye message shown on unsubscribe? How can I change or stop the goodbye email? The goodbye message and email can be changed on the Subscribers/Unsubscription page.
Can I be notified when the subscriber cancels the subscription? Notification of unsubscriptions. Yes, when a contact unsubscribes a notification is sent to the email address configured on the Subscribers/Unsubscription page.
[newsletter_unsubscribe_button]. unsubscription_url. Unsubscription link.
The {unsubscription_url} tag is used to generate a personal link to be added to the newsletter to let the subscriber start the opt-out process. This tag cannot be used on a standard site page, since the subscriber is not known. The shortcode [newsletter_unsubscribe_button] can be used on the profile page content (set on the Subscribers/Profile page) or in the Subscribers/Unsubscription confirmation message to create a button that actually unsubscribes the user.
Note: the preset messages already contain the tags or shortcode correctly configured, use the default value as a starting point if something is not working with the customizations.
Does the Newsletter plugin implement the one-click unsubscribe? Yes, the one-click cancellation is already added to every email the plugin sends. The one-click subscribe is a standard header (a hidden part of emails) with some information the email client can use to add an immediate unsubscribe button. The correct name of that header is List-Unsubscribe. It’s important to know not all email clients support it and they don’t always display it (for example Gmail has support for this feature but it is activated only for some domains at the moment of writing).
List-Unsubscribe header. RFC 2369. RFC 8058. List-Unsubscribe-Post. The Newsletter plugin supports all the unsubscribe standards defined by RFC 2369 and RFC 8058 known as One-Click Unsubscribe. All details can be found on the unsubscription page.