MediaWiki extensions manual
OOjs UI icon advanced-invert.svg
Release status: stable
Implementation User activity
Description Add Google Analytics tracking to pages
Author(s) Skizzerztalk
Latest version 1.2.0 (2020-10-12)
Compatibility policy Master maintains backward compatibility.
MediaWiki 1.34+
Database changes No
License MIT License
  • $wgGTagAnalyticsId
  • $wgGTagAnonymizeIP
  • $wgGTagHonorDNT
  • $wgGTagTrackSensitivePages

The GTag extension lets you insert the new Google Analytics tracking tag on your MediaWiki site ("gtag.js").


  • Download and place the file(s) in a directory called GTag in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php :
    wfLoadExtension( 'GTag' );
    $wgGTagAnalyticsId = 'UA-xxxxxxxxx-x' or 'G-XXXXXXXX'; // replace this with your Google Analytics id
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration parametersEdit

$wgGTagAnalyticsId (string)
Google Analytics id, required.
$wgGTagAnonymizeIP (boolean, default false)
If true, anonymize the IP address sent to Google Analytics.
$wgGTagHonorDNT (boolean, default true)
If true, honor "Do Not Track" requests from browsers. If false, ignore such requests.
$wgGTagTrackSensitivePages (boolean, default true)
If true, insert tracking code into sensitive pages such as Special:UserLogin and Special:Preferences. If false, no tracking code is added to these pages.

User rightsEdit

Users granted this right will not be tracked by Google Analytics. This can be useful to exempt staff groups from being tracked, to get a better idea of what your end users are doing on the wiki.

See alsoEdit

  • Extension:Google Analytics Integration - Provides similar features although it uses a different/older Google Analytics API to perform tracking. The GTag extension makes use of the newer Google Site Tag feature to perform tracking.