Skip to content

Clarify {signature} token behavior with owner-as-mailer #707

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.1
Choose a base branch
from
+10 −7
Open

Clarify {signature} token behavior with owner-as-mailer #707

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
ebb03bb
Clarify {signature} token behavior with owner-as-mailer
promptless[bot] May 5, 2026
e1736df
Merge branch '7.1' into promptless/signature-token-owner-mailer
promptless[bot] May 15, 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
17 changes: 10 additions & 7 deletions docs/channels/emails.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -288,18 +288,21 @@

Best regards,<br/>|FROM_NAME|.

Mautic replaces the ``|FROM_NAME|`` token with the name which is also defined in the Email Settings tab.
Mautic replaces the ``|FROM_NAME|`` token with the name defined in the Email Settings tab.

Mautic uses this signature by default if the Contact doesn't have an owner assigned.
Mautic uses this signature when the Email doesn't have **Use owner as mailer** enabled.

#. Every Mautic User can configure their own signature in their account settings. Mautic uses this signature by default if the Contact has an owner assigned to them.
#. Each Mautic User can configure their own signature in their account settings. Mautic uses this signature when the Email has **Use owner as mailer** enabled and the Contact has an owner assigned.

.. important::
Copy link
Copy Markdown
Author

@promptless-for-oss promptless-for-oss May 5, 2026

Choose a reason for hiding this comment

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

Added important callout based on PR #15931 fix for {signature} token. The PR description explicitly states that "email has to have 'Use owner as mailer' enabled" and "enabling global mailer owner setting in the configuration is NOT enough" for owner signatures to work.

Source: mautic/mautic#15931

For the ``{signature}`` token to use the owner's signature, the Email must have **Use owner as mailer** enabled in its advanced settings. Enabling the global **Mailer is owner** setting in Configuration alone isn't sufficient.

If the owner doesn't have a signature configured, the ``{signature}`` token resolves to empty when owner-as-mailer is enabled.

Check warning on line 300 in docs/channels/emails.rst

View workflow job for this annotation

GitHub Actions / prose 

[vale] reported by reviewdog 🐶
[Google.Passive] In general, use active voice instead of passive voice ('is enabled').

Raw Output:
{"message": "[Google.Passive] In general, use active voice instead of passive voice ('is enabled').", "location": {"path": "docs/channels/emails.rst", "range": {"start": {"line": 300, "column": 118}}}, "severity": "INFO"}

.. note::
There are some exceptions where the Contact owner's signature isn't used, which is when a User sends an Email directly from a Contact's profile. In this case, Mautic uses the currently logged in User's signature, with the from name and Email specified in the Email send Form, and not the Contact owner. The values used are pre-filled with those of the currently logged in Mautic User.

It doesn't matter if the Contact has another owner assigned or if it doesn't have an owner at all.
When a User sends an Email directly from a Contact's profile, Mautic uses the logged-in User's signature with the from name and Email address specified in the Email send Form - not the Contact owner's signature. Mautic pre-fills these values with those of the logged-in User.

Also, when sending a test Email this is also the case.
This applies regardless of whether the Contact has a different owner assigned, or no owner at all. The same behavior applies when sending test Emails.


.. vale off
Expand Down
Loading