Skip to content

Clarify global default Preference Center resolves live at unsubscribe time #787

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
promptless-for-oss wants to merge 1 commit into
base: 7.2
Choose a base branch
from
Open

Clarify global default Preference Center resolves live at unsubscribe time #787

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/configuration/settings.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -482,7 +482,7 @@ Unsubscribe settings

* **Show Contact's preferred Channel option** - If you have multiple Channels available within your Mautic instance. For example; Email, ``SMS``, mobile push, web notifications, etc., Contacts can choose their preferred Channel. This can be useful if you are using the Marketing Messages feature of Mautic. More information about the Preference Center is available :doc:`here</contacts/preference_center>`.

* **Default Preference Center Landing Page** - Select a Landing Page to use as the Preference Center for new Emails. When creating a new Email, this Landing Page pre-populates the Preference Center field. Editing an existing Email or cloning an Email doesn't change that Email's Preference Center, even if the clone source has no Preference Center set. Read the :doc:`/contacts/preference_center` section for more information.
* **Default Preference Center Landing Page** - Select a Landing Page to use as the global default Preference Center. When a Contact unsubscribes, Mautic applies this default to any Email that doesn't have its own Preference Center, including Emails you created before setting the default and Emails you've already sent. Mautic resolves the default at unsubscribe time rather than copying it onto each Email when you create it, so changing this setting immediately updates the Preference Center for every Email without its own selection. Emails that have a Preference Center selected always use that Page. If the default Landing Page is missing, unpublished, or no longer marked as a Preference Center, Mautic falls back to its standard unsubscribe behavior. Read the :doc:`/contacts/preference_center` section for more information.

@promptless-for-oss promptless-for-oss Jun 24, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Rewrote the Default Preference Center Landing Page setting because PR #16352 changes EmailDefaultsHelper to stop copying the global default onto new Emails (applyPreferenceCenterDefault was removed from applyDefaults) and instead resolves it at unsubscribe time via the new resolvePreferenceCenter() called from PublicController::unsubscribeAction. The resolver returns null when the default Page is missing, not a Preference Center, or unpublished, which the new fallback wording reflects.

Source: mautic/mautic#16352


.. vale on

Expand Down
2 changes: 1 addition & 1 deletion docs/contacts/preference_center.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -189,7 +189,7 @@ Now when sending the Email, all recipients can click the Unsubscribe link provid

|

If you don't select a Preference Center in an Email, Mautic uses the default Preference Center styled with the default Theme.
If you don't select a Preference Center in an Email, Mautic uses the global default Preference Center set in **Configuration > Email Settings**, resolved at the time a Contact unsubscribes. If you change the global default later, any Email without its own Preference Center, including Emails you've already sent, automatically uses the new default. If there's no valid global default, Mautic falls back to a default Preference Center styled with the default Theme.

@promptless-for-oss promptless-for-oss Jun 24, 2026

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Expanded the fallback note because PR #16352 makes the global default a live default: EmailType no longer pre-populates the Preference Center field (only UTM defaults are persisted), and unsubscribeAction resolves the current email_default_preference_center_id at unsubscribe time, so changing the global default applies to already-sent Emails without their own Preference Center.

Source: mautic/mautic#16352


.. image:: images/unsubscribe.png
:align: center
Expand Down
Loading