Document tokenized From addresses for Emails by promptless-for-oss · Pull Request #727 · mautic/user-documentation

promptless-for-oss · 2026-05-26T15:59:51Z

Open this suggestion in Promptless to view citations and reasoning process

Add documentation explaining how to use Contact field tokens in Email From address and name fields, including the sender resolution hierarchy that determines which From address Mautic uses.

Trigger Events

mautic/mautic PR #16060: Allowing tokens in FROM email address and name

Tip: Use Slack message actions (⋯ menu → Update Docs) to capture doc updates without interrupting conversations 💬

Add documentation for using Contact field tokens in Email From address and name fields, including: - New section explaining tokenized From addresses in emails.rst - Sender resolution hierarchy showing priority order - Updated Email Settings in settings.rst to mention token support - Clarified Mailer is owner behavior with tokenized addresses Relates to mautic/mautic#16060

promptless-for-oss · 2026-05-26T15:59:53Z


-It's also possible to override the 'from' field in an Email with a token from your :doc:`/contacts/custom_fields` since Mautic 5.1. 
-
 Check the :doc:`/configuration/variables` documentation for a list of all the available default fields.


Added tokenized From addresses documentation based on PR #16060 which enables Contact field tokens in FromEmailHelper.php and MailHelper.php, implementing a sender resolution hierarchy: tokenized Advanced From > owner > plain Advanced From > system default (with token support).

Source: mautic/mautic#16060

adiati98

@promptless-for-oss please address the suggestions

- Fix code block indentation (use 3 spaces per RST convention) - Add blank line after note directive - Use #. for auto-numbered lists instead of explicit numbers - Change "like" to "such as" per style guidelines - Add missing comma after "For more information"

promptless-for-oss · 2026-05-26T16:17:50Z

Thanks for the review feedback, @adiati98! I've addressed all 5 suggestions:

✅ Fixed code block indentation (3 spaces)
✅ Added blank line after .. note:: directive
✅ Changed numbered list to auto-numbered #. syntax with active voice
✅ Changed "like" to "such as" in Name to send mail as description
✅ Added missing comma after "For more information"

The changes have been pushed to the branch.

adiati98

@promptless-for-oss please address the suggestions

@adiati98

Apply all 11 suggestions from reviewer @adiati98: - Add custom RST target anchors for cross-references - Fix note admonition indentation and add ref links - Add vale off/on around section heading - Bold field names consistently throughout - Improve wording for clarity

promptless-for-oss · 2026-05-30T08:55:02Z

Thanks for the detailed review, @adiati98! I've addressed all 11 suggestions:

✅ Added .. _mailer as owner: target anchor
✅ Fixed note admonition indentation and updated with :ref: links
✅ Added .. _sender resolution hierarchy: target anchor
✅ Added vale off/on around "Tokenized From addresses" heading
✅ Updated intro sentence with bolded From address and From name
✅ Updated system-wide Email Settings bullet with proper field names
✅ Updated individual Email Advanced tab bullet
✅ Bolded From address in priority order intro
✅ Updated Tokenized Email Advanced From list item
✅ Updated Plain Email Advanced From list item
✅ Updated System default sender list item

The changes have been pushed to the branch. Please let me know if anything else needs adjustment.

adiati98

@promptless-for-oss please address the suggestions

- Capitalize "Custom Field" per Mautic style conventions - Convert passive voice "is enabled" to active voice "you enable"

promptless-for-oss · 2026-05-30T09:02:48Z

Thanks for the review feedback, @adiati98! I've addressed both suggestions:

Capitalized "Custom Field" — changed to match the reviewer's suggestion
Converted passive to active voice — changed "If Mailer is owner is enabled" to "If you enable Mailer is owner"

The changes have been pushed to this branch.

Address PR review feedback: - Indent note directive to be part of bullet point - Use :ref: links to existing anchors - Bold field names in the note text

promptless-for-oss · 2026-05-30T09:54:14Z

Thanks for the review feedback, @adiati98! I've addressed the suggestion:

Fixed note admonition indentation — Added 3-space indentation before .. note:: so it's properly nested under the "Mailer is owner" bullet point, with 6-space indentation for the note content
Updated cross-reference links — Changed :doc:Mailer is owner</channels/emails> to `:ref:`mailer as owner and fixed the anchor reference from hyphenated to spaces: :ref:Sender resolution hierarchy``
Bolded field names — Added bold formatting to Mailer is owner and Advanced in the note text

The changes have been pushed to this branch.

@adiati98

Address review feedback from @adiati98 to combine the two cross-reference links into a single sentence for better readability.

promptless-for-oss · 2026-05-30T09:59:22Z

Thanks for the suggestion, @adiati98! I've combined the two links into one sentence:

For more information, see :ref:mailer as owner and :ref:Sender resolution hierarchy<sender resolution hierarchy>.

The change has been pushed to this branch.

Address PR review feedback: - Use 2-space indentation for note directive (was 3 spaces) - Use 5-space indentation for note content (was 6 spaces) - Simplify :ref:`Sender resolution hierarchy<sender resolution hierarchy>` to :ref:`sender resolution hierarchy` (lowercase, no custom text)

promptless-for-oss · 2026-05-30T10:04:53Z

Thanks for the feedback, @adiati98! I've addressed both suggestions:

Fixed note directive indentation — Changed from 3-space to 2-space indentation for the .. note:: directive, and from 6-space to 5-space for the note content, to match unordered list formatting conventions
Simplified :ref: link — Changed :ref:Sender resolution hierarchy to `:ref:`sender resolution hierarchy (lowercase, no custom text)

The changes have been pushed to this branch.

Addressed reviewer feedback: the note was duplicative because: - The first sentence repeated the Owner sender description - The link to sender resolution hierarchy was redundant since we're already in that section - The same note exists in configuration/settings.rst The essential information about SPF/DKIM requirements and per-Email configuration is already documented in configuration/settings.rst.

promptless-for-oss · 2026-05-31T06:53:02Z

Thanks for the feedback! You're right — the note was redundant.

I've removed it since:

The first sentence duplicated the Owner sender description above
The link to sender resolution hierarchy was unnecessary within that same section
The same note already exists in configuration/settings.rst

The essential information about SPF/DKIM requirements remains available in the configuration documentation for users who need it.

promptless-for-oss requested review from a team, adiati98 and favour-chibueze May 26, 2026 15:59

promptless-for-oss commented May 26, 2026

View reviewed changes

promptless-for-oss mentioned this pull request May 26, 2026

Allowing tokens in FROM email address and name mautic/mautic#16060

Merged

adiati98 requested changes May 26, 2026

View reviewed changes

Comment thread docs/channels/emails.rst Outdated

Comment thread docs/channels/emails.rst Outdated

Comment thread docs/channels/emails.rst Outdated

Comment thread docs/configuration/settings.rst Outdated

Comment thread docs/configuration/settings.rst Outdated

adiati98 requested changes May 30, 2026

View reviewed changes

Comment thread docs/channels/emails.rst Outdated

Comment thread docs/channels/emails.rst Outdated

Address reviewer feedback on tokenized From addresses docs

ee6045c

- Capitalize "Custom Field" per Mautic style conventions - Convert passive voice "is enabled" to active voice "you enable"

Fix note directive indentation and use :ref: links

5cb30f4

Address PR review feedback: - Indent note directive to be part of bullet point - Use :ref: links to existing anchors - Bold field names in the note text

adiati98 reviewed May 30, 2026

View reviewed changes

Comment thread docs/configuration/settings.rst Outdated

Combine reference links into one sentence

103c307

Address review feedback from @adiati98 to combine the two cross-reference links into a single sentence for better readability.

adiati98 reviewed May 30, 2026

View reviewed changes

Comment thread docs/configuration/settings.rst Outdated

promptless Bot and others added 2 commits May 30, 2026 10:04

Merge branch '7.2' into promptless/tokenized-from-addresses

88b4083

adiati98 reviewed May 31, 2026

View reviewed changes

Comment thread docs/channels/emails.rst Outdated


		It's also possible to override the 'from' field in an Email with a token from your :doc:`/contacts/custom_fields` since Mautic 5.1.

		Check the :doc:`/configuration/variables` documentation for a list of all the available default fields.

Conversation

promptless-for-oss commented May 26, 2026

Uh oh!

promptless-for-oss May 26, 2026

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!

Uh oh!

Uh oh!

promptless-for-oss commented May 26, 2026

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

promptless-for-oss commented May 30, 2026

Uh oh!

adiati98 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

promptless-for-oss commented May 30, 2026

Uh oh!

promptless-for-oss commented May 30, 2026

Uh oh!

Uh oh!

promptless-for-oss commented May 30, 2026

Uh oh!

Uh oh!

promptless-for-oss commented May 30, 2026

Uh oh!

Uh oh!

promptless-for-oss commented May 31, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants