Skip to content

Comprehensive UTM tags documentation (backport of #712 to 7.2) - #922

Draft
promptless-for-oss wants to merge 2 commits into
mautic:7.2from
Promptless:promptless/utm-tags-backport-7.2
Draft

Comprehensive UTM tags documentation (backport of #712 to 7.2)#922
promptless-for-oss wants to merge 2 commits into
mautic:7.2from
Promptless:promptless/utm-tags-backport-7.2

Conversation

@promptless-for-oss

@promptless-for-oss promptless-for-oss commented Aug 13, 2026

Copy link
Copy Markdown
Contributor

Open in Promptless

Backports the comprehensive UTM tags documentation from user-documentation PR #712 onto the 7.2 branch, at the maintainer's request. It replaces the single thin docs/channels/utm_tags.rst page with a dedicated eight-page UTM Tags section under docs/utm_tags/ — an overview plus per-feature guides for Landing Pages, Asset downloads, Forms, Emails, Dynamic Web Content, Campaign conditions, and Segment filters. The two inbound :doc: links (from Focus Items and Dynamic Web Content) are repointed to the new overview, the old page is removed, the UTM Tags toctree caption is added to the docs index, and CPC/DWC are added to the Vale vocabulary.

A few objective RST defects present in the source PR (a nested .. note::, a malformed inline literal, and inconsistent casing inside example-URL code blocks) are corrected in this backport; a placeholder screenshot TODO in the Forms page is carried over as-is.

Trigger Events

Synced from #712 code review (2026-08-14)
Applied maintainer @RCheesley's "Apply suggestions from code review" edits from #712 to keep this backport in step: swapped the placeholder example-URL host to example.com in docs/utm_tags/utm_tags_forms.rst and docs/utm_tags/utm_tags_landing_pages.rst (three sample URLs total). All three edits were applied verbatim. The third file changed on #712 (utm_tags_segment_filters.rst, an inline-literal typo fix on utm_content) needed no change here — that defect was already corrected in this backport, so it was a no-op.

 to 7.1)

Replicates user-documentation PR mautic#712 onto the 7.1 branch: adds an
8-page UTM Tags section under docs/utm_tags/, removes the old
docs/channels/utm_tags.rst, repoints its two inbound :doc: links, adds
the UTM Tags toctree caption, and adds CPC/DWC to the Vale vocabulary.
@@ -0,0 +1,166 @@
UTM tags overview

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.

All 8 UTM Tags pages on this branch are a verbatim backport of already-reviewed content from user-documentation PR #712 (base 7.0). Product-behavior claims are inherited from that PR's review; the Mautic app source is not in this docs repo. Objective RST-defect fixes applied during backport: flattened a nested .. note:: in utm_tags_landing_pages.rst, corrected a malformed utm_content literal in utm_tags_segment_filters.rst, and lowercased utm_medium=email inside example-URL code blocks.

Source: #712

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.

1 participant