Feedback sent successfully Thank you for your valuable feedback. We will use it to make matomo.org even better. Home Help How to IndexAs a developer, how do I log activities done within my custom plugin? Block spam and bot traffic with Tracking Spam PreventionConfigure Tracking Spam Prevention SettingsBlock tracking requests from the cloudBlock headless browsersBlock tracking requests from server-side librariesMax actions to record per visitExclude CountriesOnly track visitors from specific countriesTest the Tracking Spam Prevention Settings Can the Activity Log data be exported? Configure the Matomo MCP ServerWhat is the Matomo MCP Server?How the MCP Server worksSecurity considerationsWhat is prompt injection?Risk Levels Depending on ConfigurationSecurity recommendationsPrivacy and regulatoryControllerProcessorIndependent controller /processorPrivacy assessment1. Legal basis for processing2. Personal data exposure (Data minimisation)3. Transparency and accountability requirements4. Data protection impact assessment (DPIA)5. AI provider agreements6. Data transfers outside the EEA7. EU AI Act considerationsPrivacy Recommendations1. Disable MCP by default2. Use granular permissions3. Minimise data set4. Confidentiality and business risksInstall the Matomo MCP Server pluginData access authenticationLimitations when using OAuth 2.0 with the MCP plugin:Generate a Matomo API tokenSetup an OAuth clientNext stepsWays to use the Matomo MCPAnalytics explorationReport interpretationData analysis assistanceTechnical assistance for analytics teams Do I get access to the raw data that was tracked? Format CSS Class Selectors for Matomo TrackingExamples of correctly formatted CSS SelectorsHow 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 BigCommerceRequirementsInstall and configure the Tag Rocket AppEnable Tag Rocket API eventsAdd the Matomo tracking scriptCustomise the Matomo tracking scriptValidate the configuration How do I install the Matomo tracking code on an HTML website?RequirementsInstall with Matomo Tag ManagerFind the Tag Manager tracking codeInstall using the Matomo JavaScript codeFind the Javascript tracking codeEmbed the Matomo tracking code in the website pagesValidate the Integration ConfigurationTroubleshootingNext steps How do I install the Matomo tracking code on Backdrop CMS?RequirementsInstall the Matomo moduleConfigure Matomo trackingValidate the configurationTroubleshootingNext steps How do I make Matomo faster? How do I markup content for content tracking?HTML Data Tags (Takes Precedence)CSS TagsMore Markup Examples How do I use Extractions to track action data with Custom Dimensions?How to Set Up Extractions for Custom Dimension DataHow Matomo extracts the value using RegExPage URL Extraction ExamplePage Title Extraction ExamplePage Parameter Extraction ExampleMore Resources How do I use Matomo tracking on a website with caching (e.g. Akamai)?How to capture the cache status of a page using a Custom Dimension How do OAuth 2.0 tokens work in Matomo?OAuth 2.0 token behaviour and permissionsTechnical integration and implementation How do you configure and secure OAuth 2.0 in Matomo?Configuring OAuth 2.0 in MatomoSecurity considerations and edge cases How long will the Activity Log data be stored? How to create segments to include or exclude staff traffic based on complex IP address ranges?Before you startCreate a Custom Visit DimensionAdd the Custom Dimension to Matomo trackingMatomo JavaScript tracking codeMatomo Tag ManagerCreate a Segment for Staff trafficCreate a Segment for non-Staff traffic How to disable archiving the segment reports for specific plugins? How to display Coupon or Discount Codes in MatomoUse a Visit-scope Custom DimensionUse an Action-scope Custom DimensionCreate a Custom Report How to enforce strong passwords for all users in MatomoWhat counts as a strong password?Enable setting for strong password enforcement How to find and edit “config.ini.php”: The Matomo configuration fileMatomo CloudMatomo On-PremiseMatomo for WordPress How to identify Paid vs Organic traffic in MatomoWhat is Organic traffic?What is Paid traffic?Where to find traffic source informationOption 1: Track Paid CampaignsOption 2: Use Segments to isolate or compare traffic typesOption 3: Create Custom Dimensions for enhanced visibilityUse the Matomo JavaScript Tracking CodeUse Matomo Tag Manager1. Create a Variable2. Create a Pageview Trigger3. Configure the Matomo Analytics Tag4. Publish the Tag Manager containerRelated Topics How to import Matomo data into Microsoft Power BI Desktop How to import Matomo data into Qlik SenseBefore you startCreate a data connectionUse the REST connectorImport files to create datasetsCreate a Qlik Sense Analytics appAdd data from the Data catalogAdd data from Files and other sourcesAdd data using the Data load editorVisualise and analyse Matomo data in QlikPublish and bookmark your app How to import Matomo data into Tableau1. Connect Matomo data to TableauFile-based imports (Cloud and On-Premise)Connect Tableau directly to the database (On-Premise)Connect Tableau to a data warehouse platform (Cloud)2. Create the data source in TableauTableau CloudTableau Desktop3. Build the visualisation with Matomo dataCreate an extractCreate the visualisationTableau WorksheetsDual axis (single combined chart)Dashboard with separate worksheets4. Publish and share the Tableau visualisationTableau CloudTableau DesktopNext steps How to integrate CookieScript CMP with MatomoBefore you startMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptValidate the IntegrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the IntegrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeInstall the Matomo cookie consent handling scriptValidate the Integration How to integrate CookieScript CMP with Matomo Tag ManagerBefore you startAdd a Custom HTML tag to initialise the CMPMethod 1: Consent-based TrackingUpdate the Matomo Configuration VariableCreate a Custom HTML TagValidate the IntegrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerConfigure Matomo Tag ManagerValidate the IntegrationMethod 3: Adaptive TrackingUpdate the Matomo Configuration VariableCreate a Custom HTML TagValidate the Integration How to integrate Didomi CMP with MatomoBefore you startConfigure Didomi consent managerMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptValidate the integrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the integrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeInstall the Matomo cookie consent handling scriptValidate the integrationTroubleshooting1. Load order matters2. Check the Matomo tracking code3. Confirm correct Vendor and Purpose ID4. Review security policy How to integrate GetTerms CMP with MatomoBefore you startInstall GetTerms consent managerNote about consent categories in GetTermsMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptTest the integrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerTest the integration How to integrate GetTerms CMP with Matomo Tag ManagerBefore you startInstall GetTerms consent managerNote about consent categories in GetTermsMethod 1: Consent-based TrackingTag Manager componentsUpdate the Matomo Configuration VariableCreate a Custom HTML Tag (consent handling)Test the integrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerConfigure Matomo Tag ManagerTest the integration How to integrate Klaro Open Source CMP with MatomoBefore you startMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeModify the Klaro config.js fileValidate the integrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the integrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeModify the Klaro config.js fileValidate the integration How to integrate OneTrust CMP with MatomoBefore you startMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptValidate the integrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the integrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeInstall the Matomo cookie consent handling scriptValidate the integration How to integrate Usercentrics CMP with MatomoBefore you startMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptValidate the IntegrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the IntegrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeInstall the Matomo cookie consent handling scriptValidate the Integration How to integrate Usercentrics CMP with Matomo Tag ManagerBefore you startMethod 1: Consent-based TrackingUpdate the Matomo Configuration VariableCreate a Custom HTML TagValidate the IntegrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerConfigure Matomo Tag ManagerValidate the IntegrationMethod 3: Adaptive TrackingUpdate the Matomo Configuration VariableCreate a Custom HTML TagValidate the Integration How to randomise the visitor config_id for privacyHow to apply the config_id randomisation setting in the UIHow does config_id randomisation affect analytics data?Setting enabled:Setting disabled:How does config_id randomisation affect performance?Why is this feature available? How to search for Page URLs with parameters How to secure user accounts with allowed email domains and inactivity reportsRestrict user accounts by allowed email domainsEnable monthly alerts for inactive users How to set up dual tracking with Matomo and Piwik PROHow dual tracking worksBefore you startOption 1: Add the Piwik PRO tracking code to Matomo Tag ManagerCreate the Custom HTML tagTrack custom events and goalsTest the Matomo Tag Manager setupOption 2: Modify and use both Matomo and Piwik PRO tracking codesTest the dual tracking setupImplement consent managementTest consent behaviour How to track Adobe Campaign URLs in MatomoConfigure Matomo Tag ManagerCreate a Custom JavaScript variableSet up a Pageview trigger with conditionsSet up the Matomo Analytics tagConfigure the Matomo JavaScript trackerTest the configurationTroubleshootingThe correct campaign values are not showingThe browser still shows the original cid URLNext steps How to track Mailchimp email clicks in Matomo using UTM parametersBefore you startSet up the Mailchimp email campaignNext steps How to write a GDPR-compliant Privacy NoticeBackgroundKey Principles of a GDPR Privacy NoticeWhat to include in a GDPR-compliant Privacy Notice1. Identity and Contact Details of the Data Controller2. Types of Personal Data Collected3. Purpose and Legal Basis for Processing4. Data Sharing & Third-Party Recipients5. How Long Data is Retained6. Data Transfers7. Data Subject Rights8. Automated Decision-Making & Profiling (if applicable)9. Contact Information & Complaints Integrate Consent Managers (CMP) with the Matomo Image trackerConsent for Pixel trackingBefore you startMethod 1: Consent-based TrackingInstall and modify the Image tracker codeModifying the Image tracker codeValidate the IntegrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the Integration Integrate the MCP Server with ChatGPTBefore you startCreate a ChatGPT app (connector)Enable the Matomo app for your organisationImportant limitations and maintenance notes Integrate the MCP Server with Claude CodeBefore you startClaude CLIClaude configuration file Integrate the MCP Server with OpenAI CodexBefore you startConfigure CodexUsing Codex CLI Migrate from Google Analytics 3 (Universal Analytics) to Matomo: Configure trackingGetting startedSite creationTracking code setupCustom Dimensions setupEvents setupEcommerce tracking setupFinishing up Migrate from Google Analytics 4 to Matomo: Configure trackingGetting startedSite creationTracking code setupCustom Dimensions setupEvents setupEcommerce tracking setupConversions and goalsFinishing up Set up AI Chatbot tracking with Cloudflare or Amazon CloudFrontHow AI chatbot telemetry works in MatomoSupported AI chatbots and detection rulesSet up AI Chatbot trackingInstall with CloudflareWhat the integration doesInstall with Amazon CloudFrontWhat the integration doesVerify tracking is enabledData retentionFiltering and exclusionsWhen to use the HTTP Tracking API directly Set up AI Chatbot tracking with WordPressHow AI chatbot telemetry works in MatomoSupported AI chatbots and detection rulesBefore you setup trackingSet up AI Chatbot trackingVerify tracking is enabledData retentionOther set up methods Set up OAuth 2.0 authentication for the Matomo APIHow the OAuth 2.0 process worksPermission scopes in OAuth 2.0Manage OAuth 2.0 settingsHow to configure OAuth 2.0 in MatomoCreate the client (application)Client Credentials flow (server-to-server)Manage OAuth clientsPause/resume OAuth 2.0 client 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?Matomo for WordPress How do I update the currency used in the website? How do I specify which websites to load by default in Matomo? 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?Enabling category structure in the Page titles report After the top 500 or top 1000 rows, Matomo automatically groups pages, keywords, websites, etc. under the label “Others”; How do I force Matomo to not limit the data?Custom dimensions rows limitCustom ReportsMedia AnalyticsOther report limitsReprocessing reportsArchiving all data (unlimited rows)Matomo Cloud customers How do I make the Matomo Analytics RAW data available to my data warehouse?Export all data using our HTTP APIImportant note about high traffic Matomo servers2) 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?Solution 1) Tracking each website section as its own website and use Roll-Up ReportingSolution 2) One website, one custom dimension, and several custom reports and/or segmentsCreate a new custom dimension in “Action” scope(recommended) Create a new custom dimension in “Visit” scopeCreating the “Sections” custom reports(optional) Create segments for important “Sections” How do I track how many users open and read my newsletter emails (using a pixel / beacon)?Tracking even more data: the user ID exampleImportant note about inaccurate dataOther resources 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?Configuring logging in MatomoEnabling logging for Matomo TrackerUsing the LogViewer plugin How do I force the reports to be re-processed from the logs?1) Invalidate the existing historical aggregate reports2) Re-process your reportsif you’re using Matomo 3.xSummary How do I write SQL queries to select visitors, list of pageviews, searches, events in the Matomo databaseMatomo Database Schema documentationSQL query to select all visits and actions (during a certain time period)SQL query to select all visits and actions for a specific website IDSQL query to count number of unique visitors (Visitor IDs) for a specific period and websiteSQL Query to count the number of Unique Pageviews (Based on the Page URL) for a given ID Site.SQL query to select the list of all site searchesSQL query to select all actions where an Event action contains a specific stringSQL query to select all Event names, where the Event action contains ‘search’SQL query to select all page title pageviews (Each row is a unique pageview for a Page Title)SQL query to count the total number of pageviews for each Page Title:SQL query to select all page URL pageviews (Each row is a unique pageview for a Page URL)SQL query to count the total number of pageviews for each Page URL:SQL query to count and select all Outlinks from specific Page URLs:SQL query to count and select all Outlinks from specific Site SearchesSQL Query to count the number of hits tracked in Matomo for all sites by ID SiteDelete Alerts for a UserSQL Query for discovering which users have superuser permissionSQL query to measure the number of unfinished invalidation jobsSQL query to measure the total database size and individual tablesSQL query to retrieve last login timestamp for Matomo UsersMore resources and SQL tipsExporting RAW visitors and actions data via the HTTPS API (Alternative) How do I force Matomo to use SSL (https) for improved security?Important Note: Enabling SSL (https://) in Matomo without first ensuring that you can load Matomo over SSL may cause Matomo to not be accessible.Note How to track error pages (404 pages) in Matomo? How do I track visits on my intranet?What is different between a normal website and an intranet website?To make sure that all unique visitors are tracked correctly in your intranetHow do I get accurate geolocation for people viewing my Intranet site?If your whole Matomo instance is setup in the intranet only (no internet)How do I view data for more than 500 pages? How do I add a Javascript heartbeat timer to measure time spent by visitors on my pages, 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?More detailsLatest 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 accessUsing a two-factor authentication recovery codeWhen you don’t have access to your mobile device or your recovery codes How do I completely disable the Two-factor feature in Matomo? How do I include Matomo reports within an Iframe? 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?Advanced instructions How do I configure my Matomo server to allow cross domain requests? (CORS)Security notesHeatmaps & Session Recordings How do I delete old visitors statistics for a given website and/or date?Delete visits using the UIDelete visits using a console commandDelete visits using SQL queryDelete actions (pageviews, events…) using a SQL query How do I delete rows of a report and specific visits to clean-up some of the reporting data?To delete specific parts of a report, or specific visits, follow the steps below: How do I export data from Matomo in CSV, TSV, XML, or JSON format? 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?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?Determine the IP address you need to searchIf you are not anonymising the Visitor IPIf you are anonymising the Visitor IP in MatomoDeleting the tracked dataRelated FAQs How do I accurately measure the same visitor across multiple domain names (cross domain linking)?Tag Manager InstructionsAdvanced: Handling Dynamically Generated LinksGoal funnel conversion across multiple domainsA/B tests across domainsCross-domain tracking and Roll-Ups How do I search within reports?Search for special charactersSearch for rows that don’t match a sub-stringIf you can’t find the row you’re searching for 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?Option 1: Segment using the built-in Profilable conditionOption 2: Segment using a Custom DimensionCreate the Custom DimensionConfigure the Matomo tracking codeConfigure Matomo Tag ManagerCreate the Consent-based Segment 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)Step 1 (required)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? Migrate from Google Analytics to Matomo: Import GA dataPlan your migration from Google Analytics to MatomoImporting and tracking to the same website in MatomoImporting as a backup of your GA reportsRecommended steps for migrating from Google Analytics to Matomo Cloud:Recommended steps for migrating from Google Analytics to Matomo On-Premise:Finish setting up MatomoWorking with the other Google productsFinal steps to remove Google Analytics Some of the Page URLs are tracked in duplicate (for example both “Default.aspx” and “default.aspx” are tracked as different pages), how do I force Matomo to record them 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?Disable Matomo TrackingDisable the Matomo User Interface and APIsRe-enable Tracking API and UI How do I enable “Unique Visitors” metric for Yearly reports and for Custom Date Ranges? How do I disable the visits log or the visitor profile feature?Disable for all websitesDisable only for specific website(s) 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?Step 1. Create a file for the service workerStep 2. Register service workerStep 3. Initialise offline trackingExample:Known limitationsWe need your feedbackRunning into any issues?Are you a service worker or IndexedDB pro? 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? Configure Matomo Analytics to comply with CNIL consent exemptionCNIL consent-exemption for website analyticsStart my CNIL compliance checkRestrictions and disabling the CNIL configurationHow to interpret the assessment resultsSelf-Assessment TableAdditional conditionsWhat the CNIL configuration affectsDevice model and screen resolution detection disabledMajor browser and operating system versionsEcommerce – RestrictedEcommerce – Order ID anonymisationPII data filteredTurn off Visits Log and Visitor profilesMarketing and advertising featuresReferrer AnonymisationUser ID disabledIP address anonymisationData retention periodLimit available segmentsSegmented data rounding enabledA/B TestingHeatmaps – Disable Heatmap/Session RecordingThird-party cookiesOpt out How do I enable third party tracking cookies, as well as the existing first party cookies? How do I see Page Performance reports?Page Performance TablesAccess the Page Performance Report from any Page TableAnalyse the performance of specific pageviews How do I track a website within an iframe How do I customise the Matomo Campaign parameters?Override default campaign parametersUpdate the server configurationUpdate 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?1. Exclude visits using an IP address or IP address range2. Exclude visits using an ignore cookie3. Exclude visits using an opt-out cookie4. Exclude visits that don’t match your domain5. Exclude visits based on User-Agent6. Exclude visits using tracking code modifications7. Use segments to exclude certain visitors from reports8. Delete tracked data How do I share a custom dashboard template with another user?How to Share Custom Dashboards With Other UsersMore 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?If you use Matomo 3.0 or newerIf you use Matomo 2.1 or newer:If you use Matomo older 2.0.3 or older:Related How do I exclude all requests with a specific User Agent from statistics ?Some bots are not tracked by defaultHow 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?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?How to select visitors within a certain IP rangeHow to exclude visitors within a certain IP range How to invalidate the past historical reports so they can be re-processed from the logsOption 1: The InvalidateReports pluginOption 2: Use a console commandReprocess only one specific reportWhen to use core:invalidate-report-data and core:archivecore:invalidate-report-datacore:archiveOption 3: Use the HTTP APIInvalidate a specific segment (optional)Target a specific period type (optional)Cascading invalidation behaviour How do I anonymise previously tracked raw data (visitors, visits) to remove personal data and delete database column values?Start the data anonymisation process How do I anonymise the Referrer information?Configure Privacy settings1. Don’t anonymize the referrer2. Remove query parameters from referrer URL3. Keep only the domain of a referrer URL4. Don’t record the referrer URL but still detect the type of referrer 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?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?Notes How do I prevent Matomo from creating a new visit after 10000 actions? How can I automatically stop long running database queries?Archiving queriesLive queriesAdvertising Conversion Export 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?Activate the GeoIp2 Plugin in MatomoInstalling libmaxminddbInstalling Extension 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?Configuring Matomo How do I install the GeoIP 2 module for Nginx?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?As of Matomo 4.12.0: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?Track users and customers with an affiliate URL parameterReporting affiliate conversions and revenueAccurately credit your affiliates who first brought you the leadsCustomising the affiliate URL parameterLimitations 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?Overwrite label within Matomo appOverwrite 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)What is a Custom Variable?Use Custom Dimensions insteadRequirementsTracking a Custom VariableCustom Variable ReportingCustom Variables in the Visits LogUsage of your Custom Variables slotsData Limits for Custom VariablesReferences 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)?Enable Tracking for visitors who have JavaScript disabledUsing Server-side Tracking or Log Analytics How do I exclude specific tracking requests in Matomo?RequirementsConfigurationMore examples: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 PGP 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)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?Matomo On-Premise How do I fix the errors “Unable to write in the cache directory” or “The directory matomo/tmp/cache/*” is not writable.”?General Solution How to fix the error “Matomo is unable to write to some directories”? Create and manage websitesAdd a WebsiteTracking data anonymisation settingsUpdate and Delete Websites How do I backup and restore the Matomo data?Export your MySQL/MariaDB database in a fileRestore the backed up database dumpAdvanced: when Matomo is setup in writer/reader configuration (DB replication)Multiple DB nodes: use mysqldump on a DB slave/read replicaSingle DB node with a large database: use Percona XtraBackup. 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?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’Include a valid authentication tokenLate tracking from mobile SDKsUnderstanding token behaviour with GET vs POST requestsGET requestsPOST requests 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?When would I want to prevent Superusers from doing these actions?How do I prevent Superusers from doing high risks administrative actions? How can I change the language of Matomo as a user?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?Segmenting for a specific DateSegmenting 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)Create the segment and view the reportSegmentation 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 geolocationMaintaining Geolocation DatabasesReports: Continent, Country, Region, City & ProviderGeolocation Configuration FAQs 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?Send identical tracking data to multiple Matomo serversSend different data to multiple Matomo servers How do I track pages across Multilingual sites or sites in Multiple Languages in Matomo?Option 1. Generate a custom page URL and track it as a Custom Dimension.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?1) Use the Heatmaps and Session Recording Plugin2) Use the Matomo Tag Manager to track scroll percentage.3) Manually track scroll percentage in your website using events and triggering the event using JavaScript code on your website. How to enable file:// protocol trackingWhy is no data tracked for local files? How can I purchase a Matomo Cloud plan?If you want to purchase a Matomo Cloud plan, please follow the steps below: How do I find the Hits per year when using Google Analytics?To find the number of hits per month in Google AnalyticsTo find the number of hits per month in Google Analytics 4 (GA4) How do I login to Matomo?If you are using Matomo and don’t remember how to login, please follow the steps below.How to login using Matomo On-premise:How to login using Matomo Cloud:How to login using Matomo for WordPress: How do I setup Auto-Archiving script to run using systemd on a Linux system instead of cron?Steps to setup auto-archiving with systemd1. Setup a ‘service’ file which tells systemd what command to run2. Setup a ‘timer’ file, which tells systemd when to run the command3. start the timer and make it automatically restart on system rebootA note on auto-archiving logs and systemd How to track your subscription business with MatomoTracking subscription information in MatomoCustomising your trackingTracking renewalsUnderstanding your subscription business to get actionable insightsSubscriptions over timeComparingAnalysing user behaviour to understand what leads to sign ups, cancellations, and moreThings you want to look out for or find while learning more about your usersAdvanced analysisSegmentingCustom reports Include & Customise Matomo for your Projectconfig/config.ini.php: The Matomo Config Filebootstrap.php: Execute Custom Code Before Matomo RunsCall the API in PHPUse a custom plugin, or build your own Measure 100% of Ecommerce interactions using server-side trackingWhy this guide?AssumptionsRequirementsServer side implementation in your Ecommerce platformA. When there is a new ecommerce order1. Check that this order has not yet been recorded in Matomo2. Store some metadata about the customer along with the order3. Record the ecommerce order and all products to Matomo by sending an HTTPS Tracking API requestB. When there is a new cart update1. Record the ecommerce cart update and all products to Matomo by sending an HTTPS Tracking API requestLimitations How to integrate Osano CMP with MatomoBefore you startMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptValidate the IntegrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the IntegrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeInstall the Matomo cookie consent handling scriptValidate the Integration How to integrate Cookiebot CMP with MatomoBefore you startMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptValidate the IntegrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the IntegrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeInstall the Matomo cookie consent handling scriptValidate the Integration How to integrate CookieYes CMP with MatomoBefore you startMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptValidate the IntegrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the IntegrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeInstall the Matomo cookie consent handling scriptValidate the Integration How to integrate Tarte au Citron CMP with MatomoBefore you startUse Automatic or Manual modeMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptValidate the IntegrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the IntegrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeInstall the Matomo cookie consent handling scriptValidate the Integration How to integrate Klaro Cloud CMP with MatomoBefore you startSet up Klaro CMPMethod 1: Consent-based TrackingInstall and modify the Matomo tracking codeInstall the Matomo consent handling scriptValidate the integrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the Consent ManagerValidate the integrationMethod 3: Adaptive TrackingInstall and modify the Matomo tracking codeInstall the Matomo cookie consent handling scriptValidate the integration How to integrate Complianz for WordPress CMP with MatomoBefore you startInstall the Matomo pluginInstall the Complianz GDPR/CCPA Cookie Consent pluginMethod 1: Consent-based TrackingConfigure Complianz consent managerRemove/disable Matomo trackingValidate the integrationMethod 2: Opt-out Tracking (CNIL Exemption)Configure the consent managerValidate the integrationMethod 3: Adaptive TrackingConfigure Complianz consent managerRemove/disable Matomo trackingValidate the integration Send us your feedback about this page Thanks for contacting us! We will get in touch with you shortly. Feedback on this page "*" indicates required fields Email* Your email address so we can reply to your message.Message*Write your message to the Matomo team here.Are you human: what is 8+5?*Your information will be used only to answer you. Your data will be processed by us, our hosting provider, and our support ticket provider. For more information have a look at our privacy policy.To submit this form please answer the above captcha. Δ Navigate to