Matomo

01What it is and how it works

Matomo (formerly Piwik) is a web analytics platform that you install on your own server or subscribe to as a cloud service. It works by placing a JavaScript tracking code on every page of your site. When a visitor loads a page, the code sends a request to your Matomo server with details like the page URL, referrer, browser, screen resolution, and a unique visitor ID stored in a first-party cookie. The server processes this data and stores it in a MySQL or MariaDB database. You then view reports through a web interface that shows metrics such as visits, pageviews, bounce rate, time on site, and conversions. Matomo also supports server-side tracking via its HTTP API, which is useful for mobile apps or server-to-server scenarios. Unlike many analytics tools, Matomo keeps all data on your infrastructure, giving you full ownership and compliance with privacy regulations like GDPR. It includes features like heatmaps, session recordings, A/B testing, and funnel analysis through optional plugins.

02What to do about it

If you want to start using Matomo, first decide between self-hosting and the cloud version. For self-hosting, download the latest release from matomo.org, upload it to your server, and run the installation script. You will need a web server (Apache or Nginx), PHP 7.2 or higher, and a MySQL database. After installation, copy the JavaScript tracking code and paste it into the `` of every page on your site. Then configure goals to track conversions — for example, a thank-you page after a signup. Set up custom dimensions to segment data by campaign source or user type. Enable the privacy features: anonymize IP addresses, set cookie expiration, and add a consent manager. If you use the cloud version, create an account, add your website URL, and follow the same tracking code steps. Within a week, you should have enough data to review the dashboard and identify trends. Use the real-time widget to verify that tracking is working. Schedule automated email reports for your team.

03How it is measured or noticed

You measure Matomo's performance by looking at the data it collects. Key metrics include the number of unique visitors, pageviews, bounce rate (percentage of single-page sessions), average time on site, and conversion rate for defined goals. You can also track ecommerce transactions, downloads, and outbound links. To notice if something is wrong, check the 'Tracking Code Status' report in the administration panel — it shows whether the JavaScript code is installed correctly on your pages. Compare your Matomo data with server logs or other analytics tools to spot discrepancies. A sudden drop in traffic often indicates a tracking code error, a blocked script, or a change in visitor behavior. Matomo also provides a 'Health Check' that reports on server performance and data processing speed. If you use the heatmap or session recording plugins, you can visually notice where users click or scroll.

04Common mistakes

• Not excluding your own visits. Configure the 'Exclude IP addresses' setting or use the 'Ignore' feature for your user account to avoid inflating traffic data.
• Forgetting to set up goals. Without goals, you cannot measure conversions or track the success of campaigns.
• Using the default tracking code without customizing it. Add custom dimensions, event tracking, and ecommerce tracking to capture the data that matters to your business.
• Ignoring privacy compliance. Matomo offers a built-in consent manager and anonymization features — failing to enable them can lead to legal issues under GDPR or CCPA.
• Self-hosting on underpowered servers. Matomo requires adequate CPU, RAM, and database performance, especially for high-traffic sites. A shared hosting plan may cause slow reports or data loss.
• Not updating Matomo regularly. Security patches and new features are released frequently; staying on an old version exposes your data and limits functionality.

05Limits

Matomo is not a replacement for all analytics needs. It does not provide real-time streaming for extremely high-traffic sites — the data is processed in batches, so reports may lag by a few minutes. Self-hosted Matomo requires ongoing server maintenance, database tuning, and backup management. The free version lacks some advanced features like A/B testing and funnels, which require paid plugins. Matomo is often confused with Google Analytics because both track websites, but Matomo gives you full data ownership and does not share data with third parties. It is also not a marketing automation platform; it does not send emails or manage campaigns natively. For very large datasets (millions of visits per day), you may need to scale your infrastructure or use the cloud version with higher-tier plans. Matomo's session recording plugin has storage limits and may not capture all interactions on single-page applications without extra configuration.

06Worked example

A marketing team launches a paid search campaign with a unique UTM parameter 'utm_source=google&utm_medium=cpc&utm_campaign=spring_sale'. They add the Matomo tracking code to their site and create a goal for the 'order-confirmation' page. After one week, they open the 'Marketing' report in Matomo, filter by campaign 'spring_sale', and see 1,200 visits, a 45% bounce rate, and 80 goal conversions. They compare this to the organic traffic report and calculate a cost-per-conversion of $12.50. The team then decides to increase the campaign budget because the conversion rate is higher than the site average.

Frequently asked questions

More in Measurement