Customize Your Unsubscribe Page

When your subscribers click on the "Unsubscribe" link at the bottom of your newsletters, they will be directed to MailPoet's default Confirmation page.

The Unsubscribe is a two-step process:

1

Confirmation page: the first page displayed will ask the subscriber to confirm they want to be Unsubscribed from the list;

2

Success page: the second step shows a confirmation that the subscriber has been successfully unsubscribed.

If you want to use custom pages instead of the default ones, here's how you can do it.

Create a new page

You can create new pages to be your custom Confirmation or Success page. Simply go to your WordPress Dashboard > Pages > Add New:

Each page must contain the shortcode [mailpoet_page]

You can also add the shortcode [mailpoet_manage text="Manage your subscription"] for the Success page, in case the user had been accidentally unsubscribed, so they can manage their subscriptions. 

There is also a helpful filter to further customize the Success page if you want to translate its text.

Set up the custom pages

After having your new pages created and published, access  MailPoet > Settings > Basics.

On the Basics tab, go to the Unsubscribe page section and select the custom Confirmation and Success page created from the drop-down menu:

You can click on the Preview link to see what your custom Unsubscribe page will look like. Don't forget to save your settings when you finished editing.

Note: If you preview your custom Unsubscribe page on the Edit Page screen, the shortcode won't render. Please use the Preview buttons above or test with Unsubscribe links in actual emails instead.

Advanced: Filter to modify the text

You can use the mailpoet_unsubscribe_confirmation_page filter to modify the default unsubscribe message.

From this:

To a custom message like this:

With this code:

add_filter( 'mailpoet_unsubscribe_confirmation_page', 'mp_modify_unsubscribe_confirmation_page', 10, 2);
function mp_modify_unsubscribe_confirmation_page( $HTML, $unsubscribeUrl ) {
	$HTML = '<hr>';
 	$HTML .= '<center>You can <a href="'.$unsubscribeUrl.'">click here</a> to unsubscribe.</center>';
 	$HTML .= '<hr>';
    return $HTML;
}

We always recommend you add these code snippets to your website using the plugin: Code Snippets.