JavaScript tracking

Matomo provides several ways to measure your visitors and their behaviour - JavaScript Tracking is typically the best way to measure your websites, web apps and intranets.

In the guides below you will learn how to use the JavaScript tracking code and the most common use cases of tracking with JavaScript. You will also find advanced information on data privacy with JavaScript tracking, how to exclude data from being tracked, and several How-to guides, including how to implement tracking in a Single Page App.

 

Use cases

Tracking mini-sites separately to give users specific permissionsAccurately measure the same visitor across multiple domain names (cross domain linking)Send tracking requests to two or more Matomo serversTrack pages across Multilingual sites or sites in Multiple Languages in MatomoHow to track error pages (404 pages) in Matomo? Which URLs are 404 and which referrers lead to these pages?How do I enable basic JavaScript error tracking and reporting in Matomo? (browser console error messages) Enable tracking for visitors when JavaScript cannot be used on a page (or for Visitors that have disabled Javascript)Track visits on my intranetHow are requests with a User ID tracked? (login, logout, or on multiple devices)Embed the Matomo tracking code in my website CMSTrack your subscription business with Matomo

Installation

JavaScript Tracking Client developer guide JavaScript Tracking Client API reference Is the Matomo JavaScript Tracker CSP (Content Security Policy) compatible and how do I set it up?Content tracking developer guide Migrate from Google Analytics 3 (Universal Analytics) to MatomoMigrate from Google Analytics 4 to Matomo

Single Page Apps (SPA)

Measure my single-page websites and apps with MatomoSet up Matomo offline tracking

Privacy

When cookies are disabled by a visitor (cookieless tracking), how does it impact Matomo reports accuracy?Enforce tracking without cookiesLet visitors opt-out from trackingDisable browser feature detection completelyImplementing tracking or cookie consent with the Matomo JavaScript Tracking Client 

Improve performance

Will the Matomo Analytics JS Tracker slow down my site?Improve my website pages load time and speed and minimise Matomo JavaScript Tracker performance overheadIn JavaScript Tracker, how do I enable the use of navigator.sendBeacon()?

Exclusions

Set some of my website directories or pages to not be tracked

How to

Setup Matomo to track multiple websites without revealing the Matomo server URL footprint which appears in the Javascript code in all websitesSet a custom URL using the Matomo Javascript trackerSet a custom page title using the Matomo javascript titleCreate new visit whenever a user visits my website using a new campaign or a new website referrerTell Matomo to track Unique Visitors based on the Visitor ID cookie, instead of using IP AddressCreate new visit on demand, so that several users using the same computer or browser are counted separatelyGet the time elapsed between two actions or two events in the same visit or even across multiple visitsEnable third party tracking cookies, as well as the existing first party cookiesTrack a website within an iframeTrack Page Scrolls or Page Scroll Depth in MatomoEnable Secure cookie flags in all tracking cookiesRemove the tracked domain or hostname from all page URLsEnable file:// protocol tracking

Troubleshoot

Matomo doesn’t track any visits and pages, and shows “There is no data for this report” in all reports.When the Matomo server is unavailable (down) how does this affect my websites loading speed and tracking data collection?Matomo doesn’t track Downloads and clicks on Outlinks on my website.Visits and clicks data provided by search engines, ad networks or affiliates do not match Acquisition reports in Matomo

Consent Managers (CMP)

Using Osano Consent Manager (CMP) with MatomoUsing Cookiebot Consent Manager (CMP) with MatomoUsing CookieYes Consent Manager (CMP) with MatomoUsing Tarte au Citron Consent Manager (CMP) with MatomoUsing Klaro Consent Manager (CMP) with MatomoUsing OneTrust Consent Manager (CMP) with MatomoUsing Complianz for WordPress Consent Manager with Matomo