Feedback sent successfully Thank you for your valuable feedback. We will use it to make matomo.org even better.

Home
Aide

How to

Index

As a developer, how do I log activities done within my custom plugin?
Block spam and bot traffic with Tracking Spam Prevention
1. 1. Configure Tracking Spam Prevention Settings
  2. Test the Tracking Spam Prevention Settings
Can the Activity Log data be exported?
Configure CNIL exemption opt-out tracking with a consent manager (CMP)
Configure the Facebook (Meta) Pixel tag in Matomo Tag Manager
Configure the Tracker Proxy to remove visitor IP addresses
1. 1. Enable the Tracker Proxy privacy feature
  2. How the privacy feature works
Configure tracking consent for Matomo on Shopify
Configure tracking for Crash Analytics
1. 1. Crash Analytics settings
  2. Other Crash Analytics configuration options
Create segments to identify bot traffic in Matomo
1. 1. Segments and conditions
  2. After identifying bot traffic
    1. 1. Reduce bot and spam traffic before it reaches your reports
    2. 2. Exclude specific user agents
Do I get access to the raw data that was tracked?
Format CSS Class Selectors for Matomo Tracking
1. 1. Examples of correctly formatted CSS Selectors
  2. How to find the CSS selector for an element on the page?
How can I export the Activity Log UI to embed somewhere else?
How do I access the Activity Log?
How do I check in real-time whether my goal conversions are triggered correctly on my website?
How do I configure a config setting in the config.ini.php differently for a specific site?
How do I enable Content Tracking via Matomo Tag Manager?
How do I enable Gravatar images in the Activity Log?
How do I get a list of products left in the cart?
How do I install the Matomo tracking code in Tag Rocket for BigCommerce
How do I install the Matomo tracking code on an HTML website?
How do I install the Matomo tracking code on Backdrop CMS?
How do I make Matomo faster?
How do I markup content for content tracking?
1. 1. HTML Data Tags (Takes Precedence)
  2. CSS Tags
    1. More Markup Examples
How do I use Extractions to track action data with Custom Dimensions?
How do I use Matomo tracking on a website with caching (e.g. Akamai)?
1. 1. How to capture the cache status of a page using a Custom Dimension
How do OAuth 2.0 tokens work in Matomo?
1. 1. OAuth 2.0 token behaviour and permissions
  2. Technical integration and implementation
How do you configure and secure OAuth 2.0 in Matomo?
1. 1. Configuring OAuth 2.0 in Matomo
  2. Security considerations and edge cases
How long will the Activity Log data be stored?
How to capture the correct page title in a React SPA
1. 1. Ensure the React app updates document.title
  2. Page titles in React SPAs
    1. Option 1: Use a route-to-title Custom JavaScript variable
    2. Option 2: Use a custom MTM event
How to configure the Matomo MCP Server
How to create segments to include or exclude staff traffic based on complex IP address ranges?
How to disable archiving the segment reports for specific plugins?
How to display Coupon or Discount Codes in Matomo
How to find and edit « config.ini.php »: The Matomo configuration file
How to identify Paid vs Organic traffic in Matomo
How to import Matomo data into Qlik Sense
How to import Matomo data into Tableau
How to integrate CookieScript CMP with Matomo
How to integrate CookieScript CMP with Matomo Tag Manager
How to integrate Didomi CMP with Matomo
How to integrate GetTerms CMP with Matomo
How to integrate GetTerms CMP with Matomo Tag Manager
How to integrate Klaro Open Source CMP with Matomo
How to integrate OneTrust CMP with Matomo
How to integrate Usercentrics CMP with Matomo
How to randomise the visitor config_id for privacy
How to search for Page URLs with parameters
How to secure user accounts with allowed email domains and inactivity reports
1. 1. Restrict user accounts by allowed email domains
  2. Enable monthly alerts for inactive users
How to set up dual tracking with Matomo and Piwik PRO
How to track Adobe Campaign URLs in Matomo
How to track Mailchimp email clicks in Matomo using UTM parameters
How to use AI with the Matomo API
How to write a GDPR-compliant Privacy Notice
Import Matomo data into Databricks
Integrate Consent Managers (CMP) with the Matomo Image tracker
Integrate Matomo Tag Manager with Modern SharePoint Pages (SPFx Extension)
Integrate Silktide consent manager CMP with Matomo
Integrate Silktide consent manager CMP with Matomo Tag Manager
Integrate the Matomo MCP Server with a third-party MCP client
Integrate the Matomo MCP Server with ChatGPT Web
Integrate the Matomo MCP Server with Claude Code
Integrate the Matomo MCP Server with Claude Desktop
Integrate the Matomo MCP Server with Microsoft Copilot Studio
Integrate the Matomo MCP Server with OpenAI Desktop App and Codex CLI
Link visitors between different browsers and apps using the Visitor or User ID
Migrate from Google Analytics 4 to Matomo: Configure tracking
Set up AI Chatbot tracking with Cloudflare or Amazon CloudFront
Set up AI Chatbot tracking with the HTTP Tracking API
Set up AI Chatbot tracking with WordPress
Set up Goals using Matomo Goal Recommendations
1. 1. Scan your website for Goal Recommendations
    1. Run a scan
    2. Review and create Recommended Goals
  2. Keep Goals up to date
Set up OAuth 2.0 authentication for the Matomo API
Set up tracking with the Matomo SDK for iOS
Track a website’s carbon footprint with CO2.js and Matomo Tag Manager
Track Custom Dimensions with the Matomo SDK for iOS
Track events with the Matomo SDK for iOS
Track Goals using server-side tracking
Track goals with the Matomo SDK for iOS
Track Meta Pixel Events in Matomo Tag Manager
Track screen views with the Matomo SDK for iOS
Track visitors from TikTok in Matomo
What does Activity Log do?
Which events / activities are being tracked in the Activity Log?
Who develops and maintains the Activity Log plugin?
Who has access to the Activity Log?
Why is it important to keep an eye on user activities in Matomo?
How do I exclude traffic from an IP or a range of IP addresses?
How do I exclude URL query parameters from the URLs tracked, and from Pages reports?
How do I export the Raw data from Matomo (users, actions, clicks)?
How do I set the time zone for my reports?
1. 1. Change the website time zone
    1. Matomo for WordPress
How do I update the currency used in the website?
How do I specify the date used by default in Matomo reports?
How do I add more than the default 5 custom dimensions?
How do I add more than the default 5 custom variables?
How do I control the categories tree structure in the Page URLs and Page titles reports?
1. 1. Enabling category structure in the Page titles report
After the top 500 or top 1000 rows, Matomo groups pages under ‘Others’; How to change the report row limit?
How do I make the Matomo Analytics RAW data available to my data warehouse?
1. 1. Export all data using our HTTP API
    1. Important note about high traffic Matomo servers
  2. 2) Direct read-only access to the MySQL database (not available for Matomo Cloud)
How do I measure and give users access to reports for page sections / categories / mini-sites / languages?
1. 1. Solution 1) Tracking each website section as its own website and use Roll-Up Reporting
  2. Solution 2) One website, one custom dimension, and several custom reports and/or segments
How do I track how many users open and read my newsletter emails (using a pixel / beacon)?
How do I track impressions and clicks and CTR of image banners and/or internal banner ads or text ads?
How do I view Matomo application logs?
How do I force the reports to be re-processed from the logs?
How do I force Matomo to use SSL (https) for improved security?
1. 1. 1. Important Note: Enabling SSL (https://) in Matomo without first ensuring that you can load Matomo over SSL may cause Matomo to not be accessible.
    2. Note
How to track error pages (404 pages) in Matomo?
How do I track visits on my intranet?
How do I add a JavaScript heartbeat timer to measure time spent on page, including the last page of their visit?
How do I ask for user consent before tracking visitors or measuring user analytics?
How do I automatically login my users in Matomo when they go from my CMS to Matomo?
How do I know which version of Matomo I am using?
1. 1. Latest version of Matomo
How do I customise the colors, fonts, font sizes of the Opt-out form so it matches my website design and styles?
How do I enable users to login into Matomo inside an iframe?
How do I log in to my account when I cannot verify my account using 2FA – no mobile device access
1. 1. Using a two-factor authentication recovery code
  2. When you don’t have access to your mobile device or your recovery codes
How do I White Label Matomo, to change the Logo, the Colors, add custom widgets, etc.
How do I specify the URL that users should be redirected to, when they logout of Matomo?
How do I delete all statistics for a given website, or for all websites?
1. 1. Advanced instructions
How do I configure my Matomo server to allow cross domain requests? (CORS)
1. 1. Security notes
  2. Heatmaps & Session Recordings
How do I delete old visitors statistics for a given website and/or date?
How do I migrate a particular website in Matomo to a different Matomo installation?
How do I restrict viewing the analytics reports to one or more allowed IP addresses or IP ranges?
How do I set some of my website directories or pages to not be tracked?
How do I track my Single Page Applications with Matomo?
1. 1. How to setup the History Change trigger to track Single Page Applications
How do I get reports for a custom date range?
How do I remove tracking data tracked from specific IPs?
How do I accurately measure the same visitor across multiple domain names (cross domain linking)?
How do I see how long ago was a report generated?
How do I change the default email address « From: » in PDF/HTML email reports and other emails sent by Matomo?
How do I change the default email address “From:” in password reset emails?
How do I segment visitors that have been identified using tracking cookies?
How do I get Matomo to use HTTPS for links to my site instead of HTTP?
How do I force Matomo to only track Page URLs that belong to my website?
How do I send Matomo emails using SMTP server? (for example using Gmail SMTP)
1. 1. Step 1 (required)
  2. Step 2 (required for Gmail as SMTP)
How do I set a custom URL using the Matomo JavaScript tracker?
How do I track a Phonegap app with Matomo?
Track duplicate Page URLs (« Default.aspx » and « default.aspx ») as the same custom url
How do I track the URL Hash tags so the #hash appears in the Page URLs report and Visitor Log?
How do I track my RSS/Atom feed subscribers?
How do I disable all automated emails so that Matomo doesn’t send any email?
How do I momentarily disable Matomo User Interface and/or Matomo visitor Tracking?
How do I disable the Matomo Visits Log or Visitor Profiles?
How do I enable basic JavaScript error tracking and reporting in Matomo? (browser console error messages)
How do I enforce tracking without cookies
How do I set up Matomo offline tracking?
How do I setup Matomo to track multiple websites without revealing the Matomo server URL footprint which appears in the JavaScript code in all websites?
How do I enable third party tracking cookies, as well as the existing first party cookies?
How do I see Page Performance reports?
1. 1. Page Performance tables
2. Access the Page Performance report from any page table
  1. Analyse the performance of specific pageviews
How do I track a website within an iframe
How do I customise the Matomo Campaign parameters?
1. 1. Override default campaign parameters
    1. Update the server configuration
    2. Update the JavaScript tracker
How do I configure outgoing (forward) proxy in Matomo (eg. squid)?
How do I exclude / ignore my traffic or specific users from being tracked in Matomo?
How do I share a custom dashboard template with another user?
1. 1. How to share Custom Dashboards with other users
  2. More Resources
I forgot my password or username, how do I reset my password?
Keyboard shortcuts for Matomo
What is the default widgets selection and how to update the default dashboard layout
How do I change the Superuser’s password when password recovery emails are not sent?
How do I exclude all requests with a specific User Agent from statistics ?
1. 1. Some bots are not tracked by default
  2. How do I exclude new bots from being tracked?
How do I find the visitor IP Addresses?
How do I recover superuser access and give superuser permission to another account?
How do I select IP addresses or Visitor ID from the SQL database and convert binary table fields?
What is the ‘anonymous user’ in Matomo?
1. 1. Enable the anonymous user
How do I improve accuracy of « Time spent on page » and « Visit duration » metrics?
How do I select or exclude all users within a range of IP addresses?
1. 1. How to select visitors within a certain IP range
  2. How to exclude visitors within a certain IP range
How to invalidate the past historical reports so they can be re-processed from the logs
How do I anonymise previously tracked raw data (visitors, visits) to remove personal data and delete database column values?
1. 1. Start the data anonymisation process
How do I anonymise the Referrer information?
1. 1. Configure Privacy settings
How do I change the default language of the Matomo UI for all user accounts?
How do I display more than the default 15 websites in the website selector?
How do I edit my username, or the username of another user?
How do I get the number of products left in the cart by each Visitor?
How do I get the time elapsed between two actions or two events in the same visit or even across multiple visits?
How do I improve the detection accuracy of Unique visitors and Returning visitors?
How do I integrate Matomo with my existing tools and services?
How do I remove from Matomo the links to « Professional Services » and banners for Premium features?
1. 1. Here is how you can remove these commercial mentions
How do I see all user interactions in Visitor profiles and Visits log (not just the first 500)?
How do I create a new visit when a user visits my website using a new campaign or a new website referrer?
How do I create new visit on demand, so that several users using the same computer or browser are counted separately?
1. 1. 1. Notes
How do I prevent Matomo from creating a new visit after 10000 actions?
How can I automatically stop long running database queries?
How do I get the DB-IP databases or Maxmind GeoIp2 to improve accuracy of Country detection, and detect visitors’ Cities and Regions?
How do I install the PHP extension for GeoIP 2?
How do I get a license key for the MaxMind geolocation database?
How do I get the geolocation download URL for the free MaxMind DB?
How do I install the GeoIP 2 module for Apache for accurate Geo location data?
1. 1. Configuring Matomo
How do I install the GeoIP 2 module for Nginx?
1. 1. Configuring Matomo
How do I apply accurate geolocation to old visits, tracked before I enabled geo location?
How do I get company and ISP information using GeoIP2 databases?
How do I track and measure how my Matomo service is being used?
How can I add the dimensions Campaign name, Campaign medium, Campaign source, Campaign keyword, Campaign content to a custom report?
How do I add a referral exclusion in Matomo?
1. 1. 1. As of Matomo 4.12.0:
    2. Before Matomo 4.12.0:
How do I change the number of rows in scheduled email reports (csv, html or pdf) and show more than the default 23 rows?
How do I clear the various caches in Matomo?
How do I create a simple affiliates system and track new customers and new revenue for each affiliate?
How do I customise any text label such as menus, report names, column names, event names and values, custom dimension names, custom report names, dashboard names and more?
1. 1. Overwrite label within Matomo app
  2. Overwrite labels within reports data
How do I tell Matomo to track Unique Visitors based on the Visitor ID cookie, instead of using IP Address?
How do I track user acquisition and social media activity with Matomo?
How do I use Custom Variables? (deprecated)
How to change the tracking image
How to disable HTTPS for matomo.org requests?
How do I enable tracking for visitors when JavaScript cannot be used on a page (or for Visitors that have disabled JavaScript)?
1. 1. Enable Tracking for visitors who have JavaScript disabled
  2. Using Server-side Tracking or Log Analytics
How do I exclude specific tracking requests in Matomo?
1. 2. Other ways Matomo allows you to exclude traffic (directly in the Matomo UI):
How do I customise the JavaScript Tracker code on all websites at once?
How do I take notes of particular events influencing my traffic?
How do I verify the cryptographic GPG signature of Matomo packages?
How do I disable the update notification email when a new Matomo version is released?
How do I get the Visitor Geo Location data from the Visitor IP? (or in JavaScript/JSON when IP address is not known)
1. 1. 1. JavaScript / JSON API to get the visitor geo location without knowing the IP address
How do I access a real time counter of visitors currently on my site?
How do I create Custom Segments of Visitors and apply the segments to filter my report’s data?
1. 1. 1. Matomo On-Premise
How to fix the error « Matomo is unable to write to some directories »?
Create and manage websites
1. 1. Add a Website
    1. Tracking data anonymisation settings
  2. Update and Delete Websites
How do I backup and restore the Matomo data?
How do I configure Matomo Tracking for high reliability?
How do I improve my website pages load time and speed and minimise Matomo JavaScript Tracker performance overhead?
How do I make « Transitions » feature work faster on high traffic websites?
How do I remove the tracked domain or hostname from all page URLs?
How do I configure Matomo to use Redis for better Tracking API scalability?
1. 1. Instructions
How do I fix a truncated event value?
How do I fix a truncated or rounded revenue or price value?
How do I fix the tracking failure « The site does not exist. »
How do I fix the tracking failure ‘Request was not authenticated but should have’
How do I disable tracking failures notification emails?
How to configure Redis as a shared cache in a load balanced environment?
How do I configure Redis for session handling in a load balanced environment?
How do I prevent Superusers from doing specific high risks administrative actions?
1. 1. When would I want to prevent Superusers from doing these actions?
  2. How do I prevent Superusers from doing high risks administrative actions?
How can I change the language of Matomo as a user?
1. 1. 1. Follow the steps below to change the language:
In JavaScript Tracker, how do I enable the use of navigator.sendBeacon()?
How do I create a segment using the Acquisition Date condition?
1. 1. Segmenting for a specific Date
  2. Segmenting for a specific Time
How do I disable browser feature detection completely?
How do I find a specific Ecommerce Order ID details?
How do I get the most popular landing pages viewed by visitors coming through a specific channel type? (direct, website, AI, social or campaign)
1. 1. Create the segment and view the report
  2. Segmentation limitation for Referrers
How do I monitor that Matomo service is up and running?
How do I prevent Matomo from sending any email, when testing Matomo on a staging/non-prod environment?
How do I see the pages that most visitors landed on? How do I access the top pages people use before leaving the websites?
How do I submit a feature request for Matomo?
Setting up accurate visitors geolocation
How do I find a specific visitor log by segmenting on Visitor ID?
How do I downgrade from Matomo 4 to Matomo 3?
How do I decrease archiving memory usage when processing a large number of websites?
How do I send tracking requests to two or more Matomo servers?
1. 1. Send identical tracking data to multiple Matomo servers
  2. Send different data to multiple Matomo servers
How do I track pages across Multilingual sites or sites in Multiple Languages in Matomo?
1. 1. Option 1. Generate a custom page URL and track it as a Custom Dimension.
  2. Option 2. Extract the URL path and track it as a Custom Dimension without the language path
How do I set a custom page title using the Matomo JavaScript title?
How do I track Page Scrolls or Page Scroll Depth in Matomo?
How to enable file:// protocol tracking
1. 1. Why is no data tracked for local files?
How can I purchase a Matomo Cloud plan?
1. 1. If you want to purchase a Matomo Cloud plan, please follow the steps below:
How do I find the Hits per year using Google Analytics events?
1. 1. How Google Analytics events compare to Matomo hits and events
  2. Find the number of hits (events) per month in Google Analytics
How do I login to Matomo?
How do I setup Auto-Archiving script to run using systemd on a Linux system instead of cron?
1. 1. Steps to setup auto-archiving with systemd
  2. A note on auto-archiving logs and systemd
How to track your subscription business with Matomo
Measure 100% of Ecommerce interactions using server-side tracking
How to integrate Osano CMP with Matomo
How to integrate Cookiebot CMP with Matomo
How to integrate CookieYes CMP with Matomo
How to integrate Tarte au Citron CMP with Matomo
How to integrate Klaro Cloud CMP with Matomo
How to integrate Complianz for WordPress CMP with Matomo

Thanks for contacting us! We will get in touch with you shortly.

Feedback on this page

"*" indique les champs obligatoires

X/Twitter

Ce champ n’est utilisé qu’à des fins de validation et devrait rester inchangé.

Email*

Votre adresse e-mail pour que nous puissions répondre à votre message.

Message*

Rédigez ici votre message à l’intention de l’équipe Matomo.

Êtes-vous un être humain: quelle est la somme de 8 + 5?*

Vos informations ne seront utilisées que pour vous répondre. Vos données seront traitées par nos soins, notre fournisseur d’hébergement et notre fournisseur de bons d’assistance. Pour toute information complémentaire, consultez notre politique de confidentialité.

Pour envoyer ce formulaire, merci de répondre à la vérification ci-dessus.