Comprehensive UTM tags documentation (backport of #712 to 6.0) - #923
Comprehensive UTM tags documentation (backport of #712 to 6.0)#923promptless-for-oss wants to merge 2 commits into
Conversation
to 6.0) Replicates user-documentation PR mautic#712 onto the 6.0 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. The overview page's screenshot directive points to add_ga_code.png, the Google Analytics ID image present on the 6.0 branch.
| @@ -0,0 +1,166 @@ | |||
| UTM tags overview | |||
There was a problem hiding this comment.
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. Backport adaptations for 6.0: the overview page's screenshot directive points to add_ga_code.png (the image present on 6.0). Objective RST-defect fixes applied: 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
|
I noticed that some CI checks failed for this PR. I'm investigating whether the failures are caused by this suggestion. If they're unrelated or pre-existing, I'll leave this suggestion unchanged and create a separate suggestion if a standalone docs fix is needed. |
1 participant
Open in Promptless
Backports the comprehensive UTM tags documentation from user-documentation PR #712 onto the 6.0 branch, at the maintainer's request. It replaces the single thin
docs/channels/utm_tags.rstpage with a dedicated eight-page UTM Tags section underdocs/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, andCPC/DWCare added to the Vale vocabulary.Adapted for 6.0: the overview page's screenshot directive points to
add_ga_code.png, the Google Analytics ID image that exists on this branch (the 7.x branches use a differently named file).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.comindocs/utm_tags/utm_tags_forms.rstanddocs/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 onutm_content) needed no change here — that defect was already corrected in this backport, so it was a no-op.