Skip to content

Document email address validation step for unsubscribe and resubscribe - #913

Draft
promptless-for-oss wants to merge 1 commit into
mautic:7.2from
Promptless:promptless/pr-16870-unsubscribe-validation
Draft

Document email address validation step for unsubscribe and resubscribe#913
promptless-for-oss wants to merge 1 commit into
mautic:7.2from
Promptless:promptless/pr-16870-unsubscribe-validation

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

Open in Promptless

Mautic 7.x hardens the public unsubscribe and resubscribe flows against leaked email links. The {unsubscribe_url}, {unsubscribe_text}, and {resubscribe_url} tokens now resolve to a validation page: when a Contact clicks the link, they land on a 'Confirm your email address' page and must enter the email address the message was sent to before the unsubscribe or resubscribe completes. The Contact's email address is no longer embedded in the first-click URL, which protects against leaked or forwarded links.

This updates the 'Unsubscribing' section of docs/channels/emails.rst to document the new confirmation workflow, the mismatch error, and how links from older Mautic versions now behave (redirect to the confirmation page when a send record exists, otherwise a 'Record not found.' message for unsubscribe or a page-not-found error for resubscribe). It also adds a cross-reference from the Preference Center page so readers know the confirmation step precedes the Preference Center.

Files touched: docs/channels/emails.rst, docs/contacts/preference_center.rst.

Trigger Events

Mautic 7.x now shows a confirmation page where recipients enter their
email address before an unsubscribe or resubscribe link executes, and no
longer embeds the email address in the first-click URL (mautic/mautic
PR #16870). Document this in the Unsubscribing section of emails.rst,
including legacy-link behavior, and cross-reference it from the
Preference Center page.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant