From ae1e505630c32e4a5f206bbdf071b3ee6a8cfa1a Mon Sep 17 00:00:00 2001 From: John Linhart Date: Fri, 8 Nov 2024 09:51:35 +0100 Subject: [PATCH 1/3] Documenting the resubscribe_url token --- docs/channels/emails.rst | 7 ++++--- docs/configuration/variables.rst | 6 ++++++ 2 files changed, 10 insertions(+), 3 deletions(-) diff --git a/docs/channels/emails.rst b/docs/channels/emails.rst index 61005612b..560604f9c 100644 --- a/docs/channels/emails.rst +++ b/docs/channels/emails.rst @@ -323,9 +323,10 @@ Unsubscribing ************* Mautic has a built in means of allowing a Contact to unsubscribe from Email communication. You can insert various tokens into your Email to provide unsubscribe options at your desired location: -- ``{unsubscribe_text}``: inserts a sentence with a link instructing the Contact to click to unsubscribe. -- ``{unsubscribe_url}``: inserts the URL to the preferences center when it's activated, or to the unsubscribe page if not. -- ``{dnc_url}``: inserts the URL to unsubscribe from all Marketing Messages when there is an active preference center. +- ``{unsubscribe_text}``: Inserts a sentence with a link instructing the Contact to click to unsubscribe. +- ``{unsubscribe_url}``: Inserts the URL to the preferences center when it's activated, or to the unsubscribe page if not. +- ``{resubscribe_url}``: Inserts the URL to the resubscribe page no matter if the preference center is activated or not. It will resubscribe the contact. Useful for double opt out campaigns. +- ``{dnc_url}``: Inserts the URL to unsubscribe from all marketing messages when the preference center is activated. The unsubscribe URL token inserts the URL into your custom written instructions. diff --git a/docs/configuration/variables.rst b/docs/configuration/variables.rst index 9be629ee1..c0f5d5676 100644 --- a/docs/configuration/variables.rst +++ b/docs/configuration/variables.rst @@ -178,6 +178,10 @@ See :doc:`Manage Emails` for more information. - ``{tracking_pixel}`` * - Unsubscribe Text - ``{unsubscribe_text}`` + * - Unsubscribe URL + - ``{unsubscribe_url}`` + * - Resubscribe URL + - ``{resubscribe_url}`` * - Web View Text - ``{webview_text}`` * - Web View URL @@ -397,6 +401,8 @@ Alphabetical list - ``{contactfield=twitter}`` * - Preferred Channel (Preference Center) - ``{preferredchannel}`` + * - Resubscribe URL + - ``{resubscribe_url}`` * - Share Buttons - ``{sharebuttons}`` * - Success Message From 2b0d207eaf376ad1ce4d8e39c94caeba12c24f5a Mon Sep 17 00:00:00 2001 From: John Linhart Date: Tue, 12 Nov 2024 16:07:43 +0100 Subject: [PATCH 2/3] Vale fixes Co-authored-by: Ruth Cheesley --- docs/channels/emails.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/channels/emails.rst b/docs/channels/emails.rst index 560604f9c..8257530f1 100644 --- a/docs/channels/emails.rst +++ b/docs/channels/emails.rst @@ -325,7 +325,7 @@ Unsubscribing Mautic has a built in means of allowing a Contact to unsubscribe from Email communication. You can insert various tokens into your Email to provide unsubscribe options at your desired location: - ``{unsubscribe_text}``: Inserts a sentence with a link instructing the Contact to click to unsubscribe. - ``{unsubscribe_url}``: Inserts the URL to the preferences center when it's activated, or to the unsubscribe page if not. -- ``{resubscribe_url}``: Inserts the URL to the resubscribe page no matter if the preference center is activated or not. It will resubscribe the contact. Useful for double opt out campaigns. +- ``{resubscribe_url}``: inserts the URL to the resubscribe page regardless of whether there's a preference centre in use. It resubscribes the Contact. Useful for double opt out Campaigns. - ``{dnc_url}``: Inserts the URL to unsubscribe from all marketing messages when the preference center is activated. The unsubscribe URL token inserts the URL into your custom written instructions. From d05836bec61e8000f7b428e998288a2603d878e5 Mon Sep 17 00:00:00 2001 From: Ayu Adiati <45172775+adiati98@users.noreply.github.com> Date: Mon, 26 Jan 2026 11:02:15 +0100 Subject: [PATCH 3/3] fix: capitalization and passive voice --- docs/channels/emails.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/channels/emails.rst b/docs/channels/emails.rst index 8257530f1..e2e589fea 100644 --- a/docs/channels/emails.rst +++ b/docs/channels/emails.rst @@ -323,10 +323,10 @@ Unsubscribing ************* Mautic has a built in means of allowing a Contact to unsubscribe from Email communication. You can insert various tokens into your Email to provide unsubscribe options at your desired location: -- ``{unsubscribe_text}``: Inserts a sentence with a link instructing the Contact to click to unsubscribe. -- ``{unsubscribe_url}``: Inserts the URL to the preferences center when it's activated, or to the unsubscribe page if not. +- ``{unsubscribe_text}``: inserts a sentence with a link instructing the Contact to click to unsubscribe. +- ``{unsubscribe_url}``: inserts the URL to the preferences center when it's activated, or to the unsubscribe page if not. - ``{resubscribe_url}``: inserts the URL to the resubscribe page regardless of whether there's a preference centre in use. It resubscribes the Contact. Useful for double opt out Campaigns. -- ``{dnc_url}``: Inserts the URL to unsubscribe from all marketing messages when the preference center is activated. +- ``{dnc_url}``: inserts the URL to unsubscribe from all Marketing Messages when you activate the preference center. The unsubscribe URL token inserts the URL into your custom written instructions.