Update link-tracking note for removal of legacy mautic:disable-tracking attribute in 8.0 - #920
Conversation
…ng attribute in Mautic 8.0
| .. note:: | ||
|
|
||
| Use ``data-mautic-disable-tracking="true"`` for all new Emails and templates, as Mautic has deprecated the ``mautic:disable:tracking`` attribute. | ||
| Use ``data-mautic-disable-tracking="true"`` for both Segment and Template Emails. Mautic deprecated the legacy ``mautic:disable-tracking`` attribute and removes it in Mautic 8.0. Once removed, the legacy attribute no longer disables link tracking, so update any Segment or Template Emails that still use it to ``data-mautic-disable-tracking="true"``. |
There was a problem hiding this comment.
Confirms attribute names: legacy mautic:disable-tracking attribute check (line 737) carries an @deprecated since 7.x comment noting it will be removed in 8.0 and to use data-mautic-disable-tracking instead; the current data-mautic-disable-tracking="true" check is on line 743. As of this commit (8.x branch HEAD, 2026-08-12) the legacy attribute is still deprecated but NOT yet removed from the code — removal is proposed in open/unmerged PR mautic/mautic#17059 (commit f93effa159282c8efc57e85b8b92ff0f2bc64e8a), which had not been merged as of verification time.
| .. note:: | ||
|
|
||
| Use ``data-mautic-disable-tracking="true"`` for all new Emails and templates, as Mautic has deprecated the ``mautic:disable:tracking`` attribute. | ||
| Use ``data-mautic-disable-tracking="true"`` for both Segment and Template Emails. Mautic deprecated the legacy ``mautic:disable-tracking`` attribute and removes it in Mautic 8.0. Once removed, the legacy attribute no longer disables link tracking, so update any Segment or Template Emails that still use it to ``data-mautic-disable-tracking="true"``. |
There was a problem hiding this comment.
Source PR mautic/mautic#17059 ("[removal] Remove 16 pieces of deprecated code", base 8.x, commit f93effa159282c8efc57e85b8b92ff0f2bc64e8a "drop legacy mautic:disable-tracking attribute support") contains the code and UPGRADE-8.0.md bullet that will remove mautic:disable-tracking support and leave only data-mautic-disable-tracking="true". Verified via GitHub API on 2026-08-12: state=open, merged=false, merged_at=null. Doc-writer must confirm this PR has merged into 8.x (and that Mautic 8.0 has actually shipped the removal) before asserting in prose that the legacy attribute "was removed" as a completed fact; if still unmerged at publish time, reword to describe the change as planned/upcoming rather than done.
Source: mautic/mautic#17059
2 participants
Open in Promptless
Mautic 8.0 removes support for the legacy
mautic:disable-trackingHTML attribute used to opt an Email or Landing Page link out of click tracking; onlydata-mautic-disable-tracking="true"continues to work. The note in the "Tracking links in Emails" section ofdocs/channels/emails.rstpreviously described the legacy attribute as merely "deprecated," which understates the impact and would leave users of the legacy attribute unaware their link-tracking opt-out stops working after 8.0.This updates that note to state that Mautic deprecated the legacy attribute and removes it in 8.0, that once removed the legacy attribute no longer disables link tracking, and that any Segment or Template Emails still using it should switch to
data-mautic-disable-tracking="true". It also corrects the legacy attribute's spelling in the note (previously writtenmautic:disable:tracking; the actual attribute ismautic:disable-tracking).Trigger Events