# Unsubscribe page

## Unsubscribe screen <a href="#unsubscribe-screen" id="unsubscribe-screen"></a>

You should include the tag {unsubscribe}{/unsubscribe} in all your Newsletters to let your users unsubscribe from your website. The user will be then redirected to a page with three options:

![](https://4212440522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MJSTP0NoW4LxdokCv5K%2F-MJSTUAI43h876nAWlRS%2Funsubscribe.png?alt=media\&token=1051aa11-5ab0-488e-a354-0a07fec982ee)

Unsubscribe screen

* **Unsubscribe from this Mailing List**: The user will be unsusbcribed from all lists attached to the current Newsletter.
* **Unsubscribe from all Mailing Lists**: The user will be unsubscribed from all mailing lists but if you create a new mailing list and subscribe the user to it, he will receive your Newsletters.
* **Do not receive any e-mails from this website in the future**: The user will be unsubscribed from all mailing lists and flagged as "does not accept e-mails" so if you create a new mailing list and subscribe this user to it then he won't receive the Newsletters as he will still be marked as "does not accept e-mails".

## Add an unsubscribe link in your Newsletter <a href="#add-an-unsubscribe-link-in-your-newsletter" id="add-an-unsubscribe-link-in-your-newsletter"></a>

* Click on the tags button when editing your Newsletter.
* Select the tag menu "subscription"
* Insert the tag which will be replaced by a valid unsubscribe link

![](https://4212440522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MJSTP0NoW4LxdokCv5K%2F-MJSTX8tvmhLscYeEt9N%2Fpopup.png?alt=media\&token=7d009246-abeb-4d9a-9d64-2029521e8a55)

Unsub link

## Customize the unsubscribe view via the AcyMailing configuration <a href="#customize-the-unsubscribe-view-via-the-acymailing-configuration" id="customize-the-unsubscribe-view-via-the-acymailing-configuration"></a>

_These options have been implemented since AcyMailing 1.8.4_

On the AcyMailing configuration page, tab "interface", you will find an area where you can customize a few options on this unsubscribe page:

![](https://4212440522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MJSTP0NoW4LxdokCv5K%2F-MJSTZDbFe4aYu_yWi3V%2Fconfiguration.png?alt=media\&token=ddf39adc-7616-48e6-9389-ff227b777a53)

Unsub options

* You can customize the Introduction text and use the tags:
  * {user:name} to display the subscriber name
  * {user:email} to display the subscriber email address
  * {user:_customfield_} to display any other value of the subscriber profile (_customfield_ should be replaced by your custom field name)
  * {list:name} to display the list name
* If you disable the unsubscribe options, the user will be unsubscribed from all your lists without having to select this option:

![](https://4212440522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MJSTP0NoW4LxdokCv5K%2F-MJSTaMyLSChh4FktfHh%2Fwoptions.png?alt=media\&token=5fcbdfd5-0ed0-4888-98c9-c1cba61dc37a)

No unsubscribe option

## Customize the unsubscribe view with some CSS <a href="#customize-the-unsubscribe-view-with-some-css" id="customize-the-unsubscribe-view-with-some-css"></a>

You can extend the view in your own template to modify it the way you want but you can also add some CSS to your own Joomla template to customize the current design:

Each option is included in its own div. You can access each of them with #unsublist\_div , #unsuball\_div , #unsubfull\_div

So if you want to remove both options "unsubscribe from all mailing lists" and "do not receive any e-mail", then you can add this CSS to your [AcyMailing Component front-end CSS file](..#css): #unsuball\_div, #unsubfull\_div{ display:none }

## Access the unsubscribe reasons <a href="#access-the-unsubscribe-reasons" id="access-the-unsubscribe-reasons"></a>

If you edit the user profile, you can see via the tab "history" the unsubscribe reason for this user.

You can also see them all via the AcyMailing statistics page if you click on the number of unsubscribers.

![](https://4212440522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MJSTP0NoW4LxdokCv5K%2F-MJSTchT3USr7mf71VhC%2Fstatistics.png?alt=media\&token=b05a0dbe-1890-43ec-b1bb-6d98cbf1d344)

Unsubcribe reasons

## Edit the unsubscribe survey <a href="#edit-the-unsubscribe-survey" id="edit-the-unsubscribe-survey"></a>

On the AcyMailing configuration page, tab "**interfaces**", you can create your own unsubscribe survey by adding extra reasons and/or by deleting existing reasons.

![](https://4212440522-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-L_D4iy53WFAtKVs3BPA%2F-MJSTP0NoW4LxdokCv5K%2F-MJSTelSH_kNPZFzyPdZ%2Faddopt.png?alt=media\&token=869ca00c-13dc-4dad-8056-9155bd3f26b1)

Unsubscribe survey

Our default reasons are written in uppercase because we will load the translation of this string in the AcyMailing language file. You can see above each field the current translation of that string.

If you don't manage a multilingual website, don't bother with that and directly write your reasons in the fields.

## Direct unsubscribe links <a href="#direct-unsubscribe-links" id="direct-unsubscribe-links"></a>

By default AcyMailing will display an unsubscribe page where the user can select the options he wants and submit his feedback.

If you rather want to have a direct unsubscribe link with no confirmation, you can use this link in your Newsletter and the user will be immediately unsubscribed from all your mailing lists: index.php?subid={subtag:subid|urlencode}\&option=com\_acymailing\&ctrl=user\&task=saveunsub\&key={subtag:key|urlencode}\&mailid={mailid}\&unsuball=1

&#x20;You can also use that one and the user will be unsubscribed from the current mailing list only: index.php?subid={subtag:subid|urlencode}\&option=com\_acymailing\&ctrl=user\&task=saveunsub\&key={subtag:key|urlencode}\&mailid={mailid}\&unsublist=1

And this third link will not only unsubscribe the user but also set him as "do not accept emails" so he will never receive emails from your website even if you create a new fresh list and subscribe him to that newly created list: index.php?subid={subtag:subid|urlencode}\&option=com\_acymailing\&ctrl=user\&task=saveunsub\&key={subtag:key|urlencode}\&mailid={mailid}\&unsuball=1\&refuse=1
