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.

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.