Unsubscribe Forms

You can use the following shortcode to create a newsletter unsubscribe form.

[noptin is_unsubscribe=1]

This will create a form such as the one in the image below.

newsletter unsubscribe form

Remove CSS Styles

By default, Noptin applies basic styles to your form fields.

Sometimes, however, the applied styles might conflict with your theme styles. In such cases, use the shortcode below instead of the first shortcode.

[noptin is_unsubscribe=1 styles=none]

Change labels and placeholders

You can change the email field’s label and placeholder as shown below.

[noptin email_label="Email" email_placeholder="Enter your email address" is_unsubscribe=1]

Confirmation Messages

When an existing subscriber submits the form, Noptin will unsubscribe them from your newsletter and display a success message as shown in the example below.

successfully unsubscribed

In case the submitted email address does not exist, the confirmation message in the example below is shown instead.

email not subscribed error

These confirmation messages can be changed using the following shortcode attributes.

AttributeDefault Value
invalid_emailPlease provide a valid email address.
errorOops. Something went wrong. Please try again later.
not_subscribedShown when someone unsubscribes with an email that is not already subscribed.
unsubscribedYou were successfully unsubscribed.

For example,

[noptin is_unsubscribe=1 unsubscribed="Custom unsubscribe message]

Redirect Unsubscribers

Noptin allows you to redirect subscribers to any URL after they unsubscribe from your form. This is useful, for example, if you want them to fill out a survey after they unsubscribe from your form.

To do this, pass a URL to the “redirect” attribute as shown below.

[noptin is_unsubscribe=1 redirect="http://example.com/goodbye"]

Related Guides

7 responses to “Unsubscribe Forms”

  1. Tobias

    Dear Noptin-Team, dear all,
    I found a little mistake on this page. To change the error message in case of an unsubscribed mail address you have to use the attribue “not_subscribed” instead of “updated”.
    Best, Tobias

    Reply
    1. Brian Mutende

      Thanks Tobias, we’ve updated the guide.

      Reply
  2. grayleaf

    and how do i set the url of this unsubscribe page to the [[unsubscribe_url]] merge tag?

    Reply
  3. Brian Mutende

    The [[unsubscribe_url]] merge tag automatically displays the correct URL. There’s nothing more you need to do.

    If it is not working then you might be adding it somewhere you’re not supposed to. Where are you adding the merge tag?

    Reply
  4. grayleaf

    The [[unsubscribe_url]] prints as [[unsubscribe_url]], it’s not being replaced by a url. I didn’t add it anywhere, it appears in the footer (settings -> emails) by default.

    Was the plugin supposed to create it’s own unsubscribe, etc pages? Because it didn’t, i’ve created these pages using the shortcodes i.e [noptin is_unsubscribe=1]

    This footer text:

    [[blog_name]] | Unsubscribe

    prints in the emails like:

    Website Name | Unsubscribe <- *not a link, just text*

    Reply
    1. Brian Mutende

      Okay, the plugin doesn’t use normal WordPress pages to process unsubscriptions hence why it doesn’t create any pages. I think you’re either sending plain text emails or there’s a plugin on your site that strips out HTML from your emails.

      Open your campaign then send a test email to support at noptin.com

      Reply
      1. Brian Mutende

        This was caused by the Email Customizer plugin. We’ve release an update so please make sure you’re using at least version 1.0.7 of the Email Customizer plugin.

        Reply

Leave a Reply

Your email address will not be published. Required fields are marked *

Up your Marketing
Join our email list to and we'll send you occasional marketing tips
We do not send spam or sell your email address
Custom CSS Slide Example
Custom Animation Example
Default Animation