Skip to content

docs: Document token category prefixes in Email builder#805

Open
promptless-for-oss wants to merge 1 commit into
mautic:7.2from
Promptless:promptless/token-category-prefixes
Open

docs: Document token category prefixes in Email builder#805
promptless-for-oss wants to merge 1 commit into
mautic:7.2from
Promptless:promptless/token-category-prefixes

Conversation

@promptless-for-oss

Copy link
Copy Markdown
Contributor

Open this suggestion in Promptless to view citations and reasoning process

Documents the improved token dropdown organization in the Email builder's text editor. Tokens are now grouped by category (Contact, Company, Owner, Page, DWC, Focus, Asset, Email) with descriptive prefixes for easier discovery.

Trigger Events


Tip: Filter the Dashboard by labels or assignees to focus on what matters to you 🔎

Comment thread docs/channels/emails.rst

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

Inserting tokens

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.

Added "Inserting tokens" section documenting the new token category prefixes introduced in PR #15855. The PR refactored TokenPlugin.js and added TokenSorter.php to group tokens by category (Contact, Company, Owner, Page, DWC, Focus, Asset, Email) with descriptive prefixes in the CKEditor dropdown.

Source: mautic/mautic#15855

@adiati98

Copy link
Copy Markdown
Contributor

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

Add documentation for the improved token dropdown organization
in the Email builder's text editor. Tokens are now grouped by
category (Contact, Company, Owner, etc.) with descriptive prefixes
to help users find the right field quickly.

Related: mautic/mautic#15855
@promptless-for-oss promptless-for-oss force-pushed the promptless/token-category-prefixes branch from dd2ae0d to dede795 Compare June 27, 2026 09:56
@promptless-for-oss promptless-for-oss changed the base branch from 7.1 to 7.2 June 27, 2026 09:58
@promptless-for-oss

Copy link
Copy Markdown
Contributor Author

@adiati98 Done — rebased onto 7.2 and retargeted this PR's base branch accordingly.

The 7.2 branch had substantially rewritten the Tokens section (new "Tokenized From addresses" and "Sender resolution hierarchy" subsections), so the branch was rebuilt on top of 7.2 with only the intended content re-applied: the new "Inserting tokens" section now follows the "Sender resolution hierarchy" content in docs/channels/emails.rst. The net diff against 7.2 is the intended change. Example token labels were also switched from straight quotes to RST inline code (e.g. Contact: First Name) to satisfy Vale. The PR is now mergeable against 7.2.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants