Skip to content

docs: Document Preference Center Segment ordering by Public name #851

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 2 commits into
base: 7.2
Choose a base branch
from
Open

docs: Document Preference Center Segment ordering by Public name #851

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4246033
docs: Note Preference Center Segment ordering by Public name
promptless[bot] Jul 16, 2026
75ce52e
docs: bold Public name references in Segment ordering note
promptless[bot] Jul 21, 2026
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: 2 additions & 0 deletions docs/contacts/preference_center.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -71,6 +71,8 @@ Contact Segments

Use the Segments tab to add or remove a Contact from a Segment. Segments are a source for both starting Campaigns and sending Emails. Any Contact in a particular Segment is automatically part of a Campaign that has that Segment as the source. You can also use a standalone Email to manually send an Email to a Segment. If a User has opted out of a Segment they no longer receive Campaign actions or messages sent to that Segment.

Segments appear in the Preference Center in alphabetical order by Public name. If two Segments share the same Public name, Mautic orders them by their internal ID. Since Contacts see this order, set a clear Public name on each Segment to control how it appears.

@promptless-for-oss promptless-for-oss Jul 16, 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.

Documents the ordering introduced by this PR: LeadListRepository::getPreferenceCenterList() changed its query from orderBy('l.name') to orderBy('l.publicName') plus addOrderBy('l.id', 'ASC'), so Preference Center Segments now sort alphabetically by Public name with a stable secondary sort by internal ID.

Source: mautic/mautic#15850

@adiati98 adiati98 Jul 21, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

@promptless-for-oss please address the suggestions.

Suggested change
Segments appear in the Preference Center in alphabetical order by Public name. If two Segments share the same Public name, Mautic orders them by their internal ID. Since Contacts see this order, set a clear Public name on each Segment to control how it appears.
Segments appear in the Preference Center in alphabetical order by **Public name**. If two Segments share the same **Public name**, Mautic orders them by their internal ID. Since Contacts see this order, set a clear **Public name** on each Segment to control how it appears.


.. vale off

Contact's unsubscribe Email preferences
Expand Down
Loading