Update segment filter operator labels for Mautic 7.x by promptless-for-oss · Pull Request #764 · mautic/user-documentation

promptless-for-oss · 2026-06-12T11:31:41Z

Open this suggestion in Promptless to view citations and reasoning process

Updates operator names in segment filter documentation to match the user-friendly labels introduced in Mautic 7.x via PR #15027.

Changes

docs/segments/manage_segments.rst

Operator list updates: Changed operator names to match the new UI labels (equals → is equal to, not equal → is not equal to, empty → is empty, not empty → is not empty, like → contains, not like → doesn't contain, regexp → matches pattern, not regexp → does not match pattern, contains → in list)
Matching part of a string section: Updated references from the old "like" operator to the new "contains" name, and from old "contains" to new "in list"
Date filter examples: Updated example text that referenced "equals" to use "is equal to"

Trigger Events

mautic/mautic PR #15027: [UXUI-121] Simplify segment operators on creation

Tip: Tag @Promptless in GitHub PR comments to guide documentation changes during code review 🐙

adiati98 · 2026-06-15T11:07:32Z

@promptless-for-oss please rebase to 7.2 branch.

Updates operator names throughout the segment filter documentation to reflect the user-friendly labels introduced in Mautic 7.x. This change aligns documentation with the actual UI text users see when creating segment filters. Operator label changes: - equals → is equal to - not equal → is not equal to - empty → is empty - not empty → is not empty - like → contains - not like → doesn't contain - regexp → matches pattern - not regexp → does not match pattern - contains → in list

promptless-for-oss · 2026-06-15T11:15:57Z

Done, @adiati98 — rebased promptless/segment-operator-labels cleanly onto 7.2 and force-pushed (head fd99d17). The PR base is now 7.2 and it's showing as mergeable. Vale introduces no new violations, and the diff is limited to the intended operator-label updates in docs/segments/manage_segments.rst.

adiati98

@promptless-for-oss please address the suggestions.

promptless-for-oss · 2026-06-15T11:37:53Z

Thanks @adiati98 — applied both suggestions and pushed to the branch.

The date-field operator descriptions are now wrapped in .. vale off/.. vale on with tightened list formatting (plus a small punctuation/wording cleanup on the "Greater than or equal" and "Starts with"/"Ends with" examples).
The "matching part of a string" filters are now a proper bulleted list. The following paragraph and %-character content still read correctly after the new list.

Let me know if you'd like any further tweaks.

andersonjeccel

good

adiati98

@promptless-for-oss please address the suggestions.

promptless-for-oss · 2026-06-15T15:06:19Z

Thanks @adiati98 — I've applied all three suggestions:

Reworked the date-field operator description list so the "For example,..." explanations are consistently formatted as indented paragraphs under each bullet (with even spacing throughout), per your "make 'for example' consistent here" note.
Updated both "consider that today is 2022-03-05" example intros to your exact wording: Example: consider that today is 2022-03-05:

Changes are committed and pushed to the docs PR. Ready for another look.

adiati98

@promptless-for-oss please address the suggestions.

adiati98 · 2026-06-17T13:56:45Z

A few things here:

Change the image with the attached image

Update the alt text to be descriptive

Resize image by 60%

adiati98 · 2026-06-17T13:57:25Z

 .. image:: images/operators-2.png
    :alt: Screenshot showing Operators.


A few things here:

Change the image with the attached image

Update the alt text to be descriptive

Resize image by 60%

…t, and sizing - Replace operators.png and operators-2.png with updated Mautic 7.x screenshots - Make :alt: text descriptive of each screenshot's contents - Add :width: to scale both images to 60% of native size (943px, 752px)

promptless-for-oss · 2026-06-17T14:08:24Z

Thanks @adiati98 — I've addressed both image review comments and pushed to the branch:

First screenshot (operators.png, segment Filters tab):

Replaced it with your attached image.
Rewrote the :alt: text to be descriptive of the segment Filters tab and the and/or condition selector.
Added a :width: option so it renders at 60% of native size.

Operators dropdown screenshot (operators-2.png):

Replaced it with your attached image showing the expanded operator list.
Rewrote the :alt: text to describe the operator dropdown with the new Mautic 7.x labels (is equal to, is not equal to, contains, in list, etc.).
Added a :width: option so it renders at 60% of native size.

Vale passes with no new violations and the diff is limited to the two image swaps, alt-text updates, and resize options. Ready for another look.

adiati98

@promptless-for-oss please address the suggestions.

adiati98 · 2026-06-17T14:23:34Z


 .. image:: images/operators-2.png
-    :alt: Screenshot showing Operators.
+    :alt: Segment filter operator dropdown expanded for a date field, showing the Mautic 7.x operator labels such as is equal to, is not equal to, more recent than, contains, and in list.


Address the Vale warning.

Suggested change

:alt: Segment filter operator dropdown expanded for a date field, showing the Mautic 7.x operator labels such as is equal to, is not equal to, more recent than, contains, and in list.

:alt: Segment filter operator dropdown expanded for a date field, showing the Mautic operator labels such as is equal to, more recent than, contains, and in list.

adiati98 · 2026-06-17T14:24:23Z

+
+.. vale on

 .. image:: images/operators-2.png


Change the image with this one.

- Replace operators-2.png with reviewer's updated screenshot - Apply reviewer's suggested :alt: text to fix Vale warning

promptless-for-oss · 2026-06-17T14:34:25Z

Thanks @adiati98 — I've addressed both review comments and pushed to promptless/segment-operator-labels:

Vale warning / :alt: text: Applied your suggested descriptive alt text on the operator-dropdown screenshot: "Segment filter operator dropdown expanded for a date field, showing the Mautic operator labels such as is equal to, more recent than, contains, and in list."
Operator-dropdown screenshot: Replaced operators-2.png with your updated image showing the expanded operator list (is equal to, is not equal to, more recent than, contains, in list, etc.).

The existing :width: (60% render) option is retained, and Vale passes with no new violations. Ready for another look.

promptless-for-oss requested review from a team, adiati98 and favour-chibueze June 12, 2026 11:31

promptless-for-oss commented Jun 12, 2026

View reviewed changes

Comment thread docs/segments/manage_segments.rst Outdated

promptless-for-oss mentioned this pull request Jun 12, 2026

[UXUI-121] Simplify segment operators on creation mautic/mautic#15027

Merged

promptless-for-oss force-pushed the promptless/segment-operator-labels branch from 3901a79 to fd99d17 Compare June 15, 2026 11:10

promptless-for-oss changed the base branch from 7.1 to 7.2 June 15, 2026 11:10

promptless-for-oss mentioned this pull request Jun 15, 2026

Document select field operators in Segment filters #765

Merged

adiati98 closed this Jun 15, 2026

adiati98 reopened this Jun 15, 2026

adiati98 requested changes Jun 15, 2026

View reviewed changes

Comment thread docs/segments/manage_segments.rst Outdated

Comment thread docs/segments/manage_segments.rst Outdated

Address review: format operator list and matching filters as lists

2079147

andersonjeccel approved these changes Jun 15, 2026

View reviewed changes

adiati98 requested changes Jun 15, 2026

View reviewed changes

Comment thread docs/segments/manage_segments.rst

Comment thread docs/segments/manage_segments.rst Outdated

Comment thread docs/segments/manage_segments.rst Outdated

Address review: consistent 'For example' formatting and example headings

558cc4e

Merge branch '7.2' into promptless/segment-operator-labels

e8dbd28

adiati98 requested changes Jun 17, 2026

View reviewed changes

Address review: update operator dropdown alt text and screenshot

b048892

- Replace operators-2.png with reviewer's updated screenshot - Apply reviewer's suggested :alt: text to fix Vale warning

		.. image:: images/operators-2.png
		:alt: Screenshot showing Operators.

	:alt: Segment filter operator dropdown expanded for a date field, showing the Mautic 7.x operator labels such as is equal to, is not equal to, more recent than, contains, and in list.
	:alt: Segment filter operator dropdown expanded for a date field, showing the Mautic operator labels such as is equal to, more recent than, contains, and in list.

Conversation

promptless-for-oss commented Jun 12, 2026

Changes

docs/segments/manage_segments.rst

Uh oh!

Uh oh!

adiati98 commented Jun 15, 2026

Uh oh!

promptless-for-oss commented Jun 15, 2026

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

promptless-for-oss commented Jun 15, 2026

Uh oh!

andersonjeccel left a comment

Choose a reason for hiding this comment

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

promptless-for-oss commented Jun 15, 2026

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

adiati98 Jun 17, 2026

Choose a reason for hiding this comment

Uh oh!

adiati98 Jun 17, 2026

Choose a reason for hiding this comment

Uh oh!

promptless-for-oss commented Jun 17, 2026

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

adiati98 Jun 17, 2026

Choose a reason for hiding this comment

Uh oh!

adiati98 Jun 17, 2026

Choose a reason for hiding this comment

Uh oh!

promptless-for-oss commented Jun 17, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants