# How do I create an unsubscribe form in Mautic v5?

**URL:** <https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317>\
**Category:** Product Support\
**Created:** [August 29, 2024, 8:32am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317 "2024-08-29T08:32:58Z")\
**Posts on this page:** 12\
**Page:** 1

<div class="post-metadata">

**Author:** ![okagoogle](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/okagoogle/32/12661_2.png) [@okagoogle](https://forum.mautic.org/u/okagoogle)\
**Post date:** [August 29, 2024, 8:32am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/1 "2024-08-29T08:32:58Z")

</div>

**Your software**  
My Mautic version is: v5.1  
My PHP version is: v8.2  
My Database type and version is: MySQL v8

**Your problem**  
I want to create an unsubscribe form, but I don’t know how to do it. Can someone please tell me the steps? I am doing this for the first time, so please guide me…

---

<div class="post-metadata">

**Author:** ![mika](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/mika/32/12678_2.png) [@mika](https://forum.mautic.org/u/mika)\
**Post date:** [August 30, 2024, 8:22am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/2 "2024-08-30T08:22:09Z")

</div>

Do you want to create a feedback form or a page where people can unsubscribe? This might help you if the regular unsubscribe link doesn’t fit your needs: [Stuck with DNC and Preference center - #3 by Leon\_Oltmanns](https://forum.mautic.org/t/stuck-with-dnc-and-preference-center/29552/3)

---

<div class="post-metadata">

**Author:** ![okagoogle](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/okagoogle/32/12661_2.png) [@okagoogle](https://forum.mautic.org/u/okagoogle)\
**Post date:** [August 30, 2024, 8:40am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/3 "2024-08-30T08:40:17Z")

</div>

Yeh, I just want an unsubscribe form where people can opt out of the mailing list. I am very new to Mautic. Could you please tell me the steps, like what to do first and then what to do next? That way, I can do my research according to the steps

---

<div class="post-metadata">

**Author:** ![adiux](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/adiux/32/5793_2.png) [@adiux](https://forum.mautic.org/u/adiux)\
**Post date:** [August 30, 2024, 10:25am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/4 "2024-08-30T10:25:34Z")

</div>

Hi @okagoogle

Welcome to Mautic!

I think you are looking for the default Mautic unsubscribe feautres.

1. You place a link in the email: [Emails — Mautic Documentation 0.1 documentation](https://docs.mautic.org/en/5.x/channels/emails.html#unsubscribing)
2. You configure the expected behavior in the global email settings: [Mautic configuration settings — Mautic Documentation 0.1 documentation](https://docs.mautic.org/en/5.x/configuration/settings.html#unsubscribe-settings)

I think you mainly want to take a look at this setting:

> **Show Contact preference settings** - Select **Yes** to direct the unsubscribe link to your configured Preference enter. If you haven’t created a Preference Center, Mautic creates a default page based on the next 5 settings. The created page uses the default Theme for styling.

---

<div class="post-metadata">

**Author:** ![okagoogle](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/okagoogle/32/12661_2.png) [@okagoogle](https://forum.mautic.org/u/okagoogle)\
**Post date:** [August 30, 2024, 10:49am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/5 "2024-08-30T10:49:04Z")

</div>

I added the {unsubscribe\_text} to my email footer and then enabled the ‘Show Contact Preference Settings’ option in the email settings. However, when I preview the email and try to click on the unsubscribe link, I get a 404 Not Found message

 ![1](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/5/58a9735ecebfc42a8815c43be7abe7c073c56aad.png)  
 ![2](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/a/afe5ed4c5fc51685ab11ae2558195b34c9e6a50d.png)  
 ![3](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/6/6d5dd4200671fdde6cbf58f035f28942fab7a1b9.png)

---

<div class="post-metadata">

**Author:** ![adiux](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/adiux/32/5793_2.png) [@adiux](https://forum.mautic.org/u/adiux)\
**Post date:** [August 30, 2024, 12:13pm UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/6 "2024-08-30T12:13:16Z")

</div>

Check the example in the documentation. There is a `unsubscribe_url` and a `unsubscribe_text`.

`<a href="{unsubscribe_url}" target="_blank">{unsubscribe_text}</a>`

---

<div class="post-metadata">

**Author:** ![okagoogle](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/okagoogle/32/12661_2.png) [@okagoogle](https://forum.mautic.org/u/okagoogle)\
**Post date:** [September 5, 2024, 3:01am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/7 "2024-09-05T03:01:19Z")

</div>

![floorp_i3Nw9gBKXm](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/e/e639cfa08e175c892573ba04dfe9f581a2dbc1ae.png)

The default unsubscribe form looks like this, but there is nothing to unsubscribe

---

<div class="post-metadata">

**Author:** ![okagoogle](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/okagoogle/32/12661_2.png) [@okagoogle](https://forum.mautic.org/u/okagoogle)\
**Post date:** [September 5, 2024, 3:14am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/8 "2024-09-05T03:14:38Z")

</div>

i mean there isn’t any form

---

<div class="post-metadata">

**Author:** ![okagoogle](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/okagoogle/32/12661_2.png) [@okagoogle](https://forum.mautic.org/u/okagoogle)\
**Post date:** [September 5, 2024, 4:54am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/9 "2024-09-05T04:54:03Z")

</div>

![floorp_w6Br4RSBno](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/2X/2/218ca11516fe8b18a292055da4747f37d180622a.png)

I guess I understand it now, how the whole thing works. It’s a bit tricky, but I finally got it

---

<div class="post-metadata">

**Author:** ![adiux](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/adiux/32/5793_2.png) [@adiux](https://forum.mautic.org/u/adiux)\
**Post date:** [September 5, 2024, 5:26am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/10 "2024-09-05T05:26:03Z")

</div>

It looks like you have to add the fields according to your needs. I assume you want to activate “Show contact frequency preferences”. You can configure it in the Email Settings.

Note that if you just want a simple one click unsubscribe, you can disable the “Show contact preference settings”.

---

<div class="post-metadata">

**Author:** ![okagoogle](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.mautic.org/okagoogle/32/12661_2.png) [@okagoogle](https://forum.mautic.org/u/okagoogle)\
**Post date:** [September 5, 2024, 5:40am UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/11 "2024-09-05T05:40:46Z")

</div>

> [@adiux](#):
>
> Note that if you just want a simple one click unsubscribe, you can disable the “Show contact preference settings”.

Just because this was enabled, it took me a week to understand the whole thing… 😕

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex020/uploads/mautic/original/1X/43c63600fe51440378769136903f1fa2a9a34102.png) [@system](https://forum.mautic.org/u/system)\
**Post date:** [September 6, 2024, 5:41pm UTC](https://forum.mautic.org/t/how-do-i-create-an-unsubscribe-form-in-mautic-v5/33317/12 "2024-09-06T17:41:25Z")

</div>

This topic was automatically closed 36 hours after the last reply. New replies are no longer allowed.
