How UTM tags work on Mautic asset downloads¶
Mautic can capture UTM parameters when a contact downloads a managed asset (a file hosted inside Mautic). However, this behaves very differently from UTM capture on forms, emails, DWC blocks, and pages.
How it works¶
UTM values on asset downloads are only populated when the asset URL is shared directly as a link with UTM parameters manually included, for example inside an email, a button, or any other channel where you control the full URL:
https://your-mautic.com/asset/your-file?utm_source=newsletter&utm_medium=email&utm_campaign=spring_sale_2026
Those values are stored on the download record itself, not on the contact's profile. This means:
- They are used for asset reports only
- They do not appear on the contact's activity timeline and cannot be used in segment filters based on contact UTM data
Limitation: form-triggered downloads¶
A common way contacts download assets in Mautic is through a form action ("Download asset") on submit. In this flow, UTM parameters are never captured — not because of a configuration issue, but because of how Mautic generates the download URL internally:
https://your-mautic.com/asset/some-uuid?ct=eyJsZWFkIjoxMjMsImNoYW5uZWwiOnsiZm9ybSI6NH19&stream=0
The original page URL's UTM parameters (e.g. utm_source=newsletter) are never forwarded to that download request. So the UTM fields on every form-triggered download record will always be empty.
Note
If you need UTM data to appear on the contact's profile (for segmentation or timeline visibility), use the Record UTM Tags form action instead.