Test the unsubscribe link

A step-by-step guide to verify that the email unsubscribe functionality is working correctly.

Step-by-step guide

1. Navigate to the Contacts page.
2. Create a new contact using your own work email address. This will be your test profile.
3. Go to the Segments page and click New to create a test segment. You only need to give it a name and then save it.
4. Return to the Contacts list and find your test contact.
5. Check the box next to the contact's name. A bulk actions toolbar will appear at the top of the list.
6. Click the Change Segments button in the toolbar.
7. In the pop-up window, use the Add to segment(s) field to search for the segment you just created. Select it from the results, and then click Save.
8. Head over to Channels > Emails and click the New button, then choose New Segment Email.
9. Select a template that you know contains the unsubscribe link token ({unsubscribe_url}).
10. Click Builder to open the email editor and visually confirm the unsubscribe token is present.
11. Close the builder, then fill out all the required information, such as the Subject.
12. In the Contact segment field, select your test segment.
13. Click Save & Close.
14. On the email's detail page, click the Send button and follow the on-screen instructions to finalize.
15. Check your inbox for the email and click the unsubscribe link.

How do I know if I executed this process correctly?

• After clicking the link, the test contact should be marked as "Do Not Contact" in Mautic.
• You'll see a standard confirmation message.

Success

After unsubscribing, a great way to confirm everything worked is to view the test contact's record in Mautic. Their event history should clearly show that they have been marked as "Do Not Contact".

← Previous Force link color in Mautic emails Next → Setting up UTM tags in Mautic emails for analytics tracking