Welcome to the Matomo (Piwik) world!

What is Matomo?

Matomo, formerly known as Piwik, is a downloadable, Free (GPL licensed) web analytics software platform. It provides detailed reports on your website and its visitors, including the search engines and keywords they used, the language they speak, which pages they like, the files they download and so much more. Matomo (Piwik) aims to be an open source alternative to Google Analytics. Matomo is PHP MySQL software which you download and install on your own webserver. At the end of the 5-minute installation process you will be given a JavaScript tag. Simply copy and paste this tag on websites you wish to track (or use an existing plugin to do it automatically for you). To learn more about what Matomo offers, check out the list of features page. If you need professional help to make the most out of Matomo, get in touch with the Matomo analytics experts.

How is Matomo different to Google Analytics and other web analytics tools?

Matomo (Piwik) VS Google Analytics!

Matomo is the leading open source web analytics software used on more than one million websites in 200 countries. But when there are also dozens of other free and paid web analytics solutions, why choose Matomo? One of the principle advantages of Matomo is that you are in control. Unlike remote-hosted services (such as Google Analytics, Webtrends or Adobe Analytics), you host Matomo on your own server and the data is tracked inside your Mysql database. Because Matomo is installed on your server, you enjoy full control over your data. You can access the data easily via the Matomo APIs. Advanced users can use Custom Dimensions, Segmentation, or even run manual queries on the database in order to build advanced reports. Matomo can be used to measure your websites, your mobile applications, your software applications, and can also be used on your intranet portals and intranet websites.

Matomo also protects your visitor privacy with advanced Privacy features. When using Matomo for Web Analytics, you ensure that your visitors behaviour on your website(s) is not shared with advertising companies.

-> View our comparison Google Analytics VS Matomo

Matomo is an open platform which you can extend with plugins and make it your own. More than 70 plugins are available on our Marketplace (both free plugins and paid premium plugins). For even more possibilities you can even build your own plugin for Matomo or get the experts to build it for you.

Another key advantage: in Matomo there is no sampling of data. Matomo always report all of your data and will not filter out some. There is no data limit with Matomo!

To help you decide on a Web Analytics software, you might want to look at the list of features in Matomo or the online demo. Matomo offers nearly all features that other tools may offer and also has some unique features such as Real Time visitor details, Ecommerce Analytics, Visitor Profile, Real Time Visitor Maps and an awesome Mobile App for iOS and Android. Finally, our Roadmap is public, and the community can check our progress on the public issue tracker. You can even track your Android or iOS mobile apps.

You may also be interested in understanding why statistics from Matomo and my other web analytics tool (log analyzer, webalizer or javascript based like Google Analytics) are different?

If you are already using Google Analytics, you can import your historical data and reports in Matomo, see our Import Google Analytics data user guide to get started.

Happy Analytics!

How does Matomo work?

Matomo has to be installed on a server with both PHP and MySQL. At the end of the 5-minute installation, Matomo (Piwik) will give you a Javascript tag which you add to the bottom of each page of your website. Matomo will then record the activity across your website within your database. Matomo aggregates this data to provide detailed web analytics reports about your visitors, page views, referrer information, search engine keywords, Ecommerce, campaigns and much more! As well as tracking via the Javascript file, you can also import web server access logs into Matomo, or use the Tracking API.

Learn more about Matomo in our guide: What is Matomo?

Is there an online demo available?

Welcome to the online demonstration of Matomo!

You’ll find a demonstration of all the features of Matomo in the videos below.

You can also investigate the UI and real data with our online demo at https://demo.matomo.cloud.

Once you have viewed our demo, further training is available at the bottom of this page. If there are any further questions please get in touch with our support team.

Matomo overview short videos

There are also short videos available to learn more about the various features and benefits of Matomo:

  1. [Video] Welcome to Matomo
  2. [Video] Matomo’s Visitors Feature
  3. [Video] Matomo’s Behaviour Feature
  4. [Video] Matomo’s Acquisitions Feature
  5. [Video] Matomo’s Ecommerce Feature
  6. [Video] Matomo’s Goals Feature
  7. [Video] Matomo’s Multi Attribution Feature
  8. [Video] Matomo’s Funnels Feature
  9. [Video] Matomo’s Media Analytics Feature
  10. [Video] Matomo’s A/B Testing Feature
  11. [Video] Matomo’s Form Analytics Feature
  12. [Video] Matomo’s Heatmaps Feature
  13. [Video] Matomo’s Session Recordings Feature
  14. [Video] Matomo’s Custom Reports Feature
  15. [Video] Matomo’s Tag Manager
  16. [Video] Matomo and the GDPR
  17. [Video] Matomo Analytics for WordPress

Try the full Matomo experience

Please note that while the online demo and videos are useful to see what Matomo (Piwik) has to offer, it does not show all features. Indeed, the administration area is password protected. If you download, install Matomo yourself – or use a 21 day free trial of Matomo here – you will get access to many more interesting features and reports.

If you have a WordPress website

If you have a WordPress website there’s an even better option: install Matomo for free on WordPress, in a few clicks!

Want to learn more?

Take a deep dive into Matomo Analytics and Matomo Tag Manager with the training videos program:

List of all features

If you prefer seeing the list of features all in one page, check out the list of features.

Can Matomo manage multiple user accounts?

In Matomo (Piwik), you can create an infinite number of users and websites to track. For each user, you can set permissions to « view », « write », « admin » or « no permission » for a specific website, or for all websites at once. The permission system in Matomo is simple and makes it very easy to manage from a small number of websites and users to hundreds of websites and thousands of users. Learn more in the Manage Users documentation.

How do I track several websites, domains and multiple subdomains in Matomo?

You can add unlimited websites to track in Matomo (Piwik), in the Admin Websites section. In fact, Matomo scales well to thousands of websites, and a few Matomo users are tracking even more. Each Website is defined by a URL. You can track sub domains in the same Matomo website, or you can create a different website for some of your subdomains. Learn more about creating Websites in the Managing websites page.

The ‘All Websites’ dashboard is a useful first page to look at for a quick overview of the performance of all your websites over the last day or week. You can even make it your default page to load in Matomo (go to top menu Administration > Personal > Settings). If you track more than 10 websites, the Website selector will display the first ten sites only, and show a search field where you can search quickly to look at another website.

When you want to group together the data and reports from multiple websites’ domain names into the same website in Matomo, you have two solutions:

  1. you can setup Cross Domain linking in Matomo to ensure that your visitors will be accurately tracked across domains into the same visit. Learn how to setup cross-domain tracking in our FAQ How do I accurately measure a same visitor across multiple domain names?
  2. you can create a new Roll-Up and group the websites together. Roll-up reporting lets you aggregate the reports of multiple websites you select into a Roll-Up. You can create an unlimited number of Roll-ups. Learn more in the Roll-Up reporting user guide.

Other important notes:

  • When tracking user across multiple websites, it is generally important to configure First party cookie domains in the Javascript Tracking code (for better data accuracy). Learn more in the page Measuring domains and/or sub-domains.
  • If you track many subdomains in the same Matomo website, you might want to see the domain name directly in your Page Title reports. If you want to show « support.example.org/Homepage » instead of simply « Homepage », check out the JS setDocumentTitle documentation.
  • In the Admin Websites page, you can also define for each website a list of Alias URLs which contains all the other domains and subdomains that will be tracked. This will ensure they don’t appear in your « Referrer » reports.
  • The official Matomo Mobile App supports all these reports, including the ‘All Websites’ dashboard.
  • Sometimes you have only one website or app and it includes multiple « sections » (or page « categories » or « mini-site » or « multi-tenants »), and you want to track and report them separately from each other. For example your website is translated in multiple languages, and you want to see reports for each language or market (« section »). Learn more in this FAQ
  • See also: Install Matomo on one server and track visits on websites that are hosted on other servers.

How do I define and track Goal conversions?

You can add unlimited number of Goals to track in Matomo (Piwik) (newsletter subscription, file download, ‘thank you’ page, etc.). Learn more about how to track your website Goals in the Goal Tracking documentation.

How do I improve accuracy of visitors’ Country detection, and enable Cities and Regions tracking?

By default Matomo (Piwik) uses the browser language to determine location. To improve accuracy of country detection (and enable Region and City tracking), go to Matomo > Administration > Geo Location. Then, you can select the appropriate solution for your install. These include the PHP DB-IP (default), the PHP GeoIP library from Maxmind (it can provide better accuracy than DB-IP) or a server side solutions such as GeoIP Apache or GeoIP PECL modules (all solutions will also require a geolocation database such as the Lite databases from DB-IP). Learn more about Visitors geo location in Matomo.

How do I track Ecommerce orders, details of purchased products and abandoned carts on my website?

Matomo (Piwik) provides advanced Ecommerce Tracking and Reporting functionality. Learn more in the page Ecommerce Analytics.

How does Matomo ensure Privacy of my Analytics data, and Privacy of my website Visitors?

Matomo (Piwik) is the ideal Web Analytics software that respects Privacy, thanks to its Free/Libre software nature and useful Privacy settings, setting it apart from other commercial tools such as Google analytics.

To ensure and respect your visitors Privacy, you can:
1) Automatically anonymize Visitors IPs,
2) Include a analytics opt-out feature on your site (using a simple iframe),
3) Delete old visitors logs,
4) Respect Do Not Track setting.

To configure Privacy features in Matomo, log in as a Super User, click « Administration » then click « Privacy ». Learn more: Configure Privacy settings in Matomo.

PS: At Matomo, we also celebrate the Data Privacy Day every January 28th!

How does Matomo track downloads?

On many websites, you want to track when visitors download your brochure, a photo, a software, etc. Matomo (Piwik) automatically track these clicks as Downloads, and reports them under Behavior > Downloads.

Matomo will automatically detect a download as a click on a link that ends with one of the following file extensions: 7z, aac, apk, arc, arj, asf, asx, avi, azw3, bin, bz, bz2, csv, deb, dmg, doc, docx, epub, exe, flv, gif, gz, gzip, hqx, ibooks, jar, jpg, jpeg, js, mp2, mp3, mp4, mpg, mpeg, mobi, mov, movie, msi, msp, odb, odf, odg, ods, odt, ogg, ogv, pdf, phps, png, ppt, pptx, qt, qtm, ra, ram, rar, rpm, sea, sit, tar, tbz, tbz2, tgz, torrent, txt, wav, wma, wmv, wpd, xls, xlsx, xml, z, zip.

You can also force Matomo to count a click as a download by using a specific CSS class for this link. Check out the section « Force a click on a link to be recorded as a download in Matomo » in the Javascript tagging Guide.

When you use the Log Importer, files with one of the file extensions listed above will be automatically tracked as downloads in Matomo.

To increase accuracy of download tracking, you can consider enabling the use of navigator.sendBeacon().

If you have problems tracking downloads, check this FAQ.

What are Outlinks, Clicks or Unique clicks?

The Matomo (Piwik) report « Pages > Outlinks » shows the list of external URLs that were clicked by your visitors from your website pages. Matomo will track a click on a link as an « outlink » where the clicked URL is not the same domain as the website being tracked. For example, if your visitor click on a link to « piwik.org » on your website « example.org », this will be counted as an outlink in the report. For each outlink, Matomo will report the number of clicks, and the number of unique clicks. Unique clicks are the number of unique visitors that clicked to a given domain ; for example, if the same visitor clicked 3 times on the same outlink, it will be reported as 3 clicks and 1 unique click. Note that Matomo is not able to track Javascript of flash links. Only HTML links are tracked, eg.

<a href='http://linkedin.com'>LinkedIn Profile</a>

If you wish to not track clicks on your subdomains as outlinks, for example if your website is « example.org/ » and you don’t want to track outlinks to « news.example.org », you can use the Javascript function setDomains(). Read more in the documentation.

Learn more about Click Tracking in general in the Javascript tagging Guide.

To increase accuracy of outlink tracking, you can consider enabling the use of navigator.sendBeacon().

If you have problems tracking outlinks, check this FAQ.

Does Matomo track search engine bots or other spider / robots?

By default, Matomo only tracks visitors with Javascript enabled. Most bots will not execute JavaScript, although more advanced bots can now execute JavaScript.

In general there are a few options to track bots and search engine bots using Matomo depending on how you track users in Matomo:

See also: Why do Matomo data reports differ from Google Analytics and other analytics tools?

Can I use Matomo and Google Analytics / Yahoo! Analytics / WebTrends etc. at the same time?

Yes, you can use any combination of analytics packages at the same time on your pages. The downside is that your pages might take longer to load as each analytics Javascript tracking code will add some delay to the page load. We also recommend putting the Matomo (Piwik) Tracking code immediately before the closing </head> tag.

Read more about the Matomo Javascript Tracking API

When is the next release of Matomo? What is the release schedule?

The next version of Matomo (Piwik) is most likely planned for sometime in the next four weeks. Matomo is an open source project and community where being able to innovate often is key. All code is developed in the open by multiple developers all around the world.

There are two main release channels you can use for Matomo:

  • The Long Term Support (LTS) release receives only receive critical bug fixes and security fixes. (More information about Matomo LTS)
  • The Latest Matomo stable version (Download). This latest version contains all the latest fixes and improvements.

You can find the detail of the next versions in the Milestones page on Github, or learn in more detail how the Matomo development works. Our high level goals and the future of Matomo is outlined in our Roadmap page.

As part of privacy legislation worldwide including GDPR, CCPA, PECR, and ePrivacy, it is often required to display a cookie banner informing users about cookies, or consent must be obtained before tracking visitors’ data.

However there is a solution available: you can use Matomo Analytics without needing consent and without a cookie banner, by following all the steps below.

Note: this applies if you use Matomo 3.13.6 or newer.

How to avoid cookie consent banner

To avoid the analytics cookie consent banner, follow the steps below:

  1. Enable cookie-less tracking: how do I track a visitor without cookies when they have not given consent for tracking cookies?. (alternatively, if you are not planning to ask for cookie consent in the future, you can also disable all analytics cookies for all visitors). Learn more about how disabling cookies impacts data accuracy.
  2. Easily let users opt-out
  3. Mention Matomo in your Privacy Policy (see below).

No cookie consent is needed because:

  • tracking cookies are not used
  • the data is not used for any other purpose than analytics (compared to GA which uses it for other purposes and therefore always requires consent)
  • visitors aren’t tracked across websites (compared to GA which does track visitors across many websites)
  • a user cannot be tracked across days within the same website (no user profiles can be generated when cookies are disabled)

How to avoid asking user for consent (including cookie consent)

To not have to ask your visitors for consent (including the analytics cookie consent banner), then you need to make sure you do not track any personal data at all.

Follow these steps:

  • Make sure you disabled analytics tracking cookies (see section above).
  • Make sure IP addresses are anonymised (2 or 3 bytes) because the full IP address is considered personal data.
  • Make sure your Page URLs and Page titles should not include personal data/PII (such as the visitor’s name).
  • Make sure your Page Referrers URLs do not include personal data (we’ll be soon working on a new feature for this).
  • If you use features like Custom Dimensions, Custom variables, Event tracking, make sure the data you collect does not include personal data/PII.
  • If you use features such as Session Recording or Heatmap, you need to ensure you ignore any element in the page that includes personal data, so that any personal data are not tracked (learn more about masking content in Session recordings and Heatmaps).
  • If you use features such as Ecommerce tracking or User ID then you will likely need to ask for consent when these features are used. That’s because Ecommerce Order ID can be tied back to the customer, and User ID is often personal data/PII (even when replaced with a pseudonym).
  • Make sure the data collected in Matomo is used only for the audience measurement and evaluation of the website performance and not other purposes.
  • Make sure you are only tracking users on a single site and not tracking the same user across different websites.

All data you collect in Matomo without user consent should be anonymous.

Learn more details in our article about « How not to track personal data »

You must also 1) easily let users opt-out and 2) mention Matomo in your Privacy Policy (see below).

Let users opt-out

You must offer your users an easy way to opt-out from data collection, and include the opt-out iframe in a easy to access and visible page on your website, for example in your Privacy policy.

Mention analytics in your Privacy policy

Learn more about how to mention Matomo Analytics in your Privacy policy.

You can under some circumstances track your visitors using Matomo without needing cookie or tracking consent. If this applies to you, it means you can track any visitor even if 1) you don’t have any consent yet, and 2) even if the user declines or rejects cookie consent.

You need to add the following line to your tracking code:


Once you added the line above, then all visitors will be tracked with tracking cookies disabled.

If you want to ask for consent

If you then also want to ask visitors for cookie consent (optional), simply follow these instructions on how to implement cookie consent in your website or app. In a nutshell, as soon as consent for using cookies is given, simply call: _paq.push(['rememberCookieConsentGiven']); once, or call: _paq.push(['setCookieConsentGiven']); on every subsequent page view. (Then all visitors will be tracked, and tracking cookies will be set.)

And once the cookie consent has been revoked, simply call: _paq.push(['forgetCookieConsentGiven']); once, or no longer call _paq.push(['setCookieConsentGiven']); on every subsequent page view. (Then all visitors will be tracked, but tracking cookies will be disabled.)

Please note this requires Matomo 3.14.0.

Segmenting people by consent

Visitors that have cookies disabled will impact the data accuracy of some reports. That’s why we have a feature that lets you segment these two different groups (visitors that were using cookies vs visitors that weren’t using cookies). It allows you to create a segment « Visitor gave consent » and view the reports that impact the data accuracy only for these users that gave consent. When you apply this segment « Visitor gave consent » you will get reliable numbers, compared to looking at « All visits » where people without consent would make these reports inaccurate.

Which browsers are officially supported?

Matomo (Piwik) analytics UI can be used with any modern browser. To view your reports and dashboard, you can use Firefox, Chrome, Safari, Opera, Chromium, IE or others.

In Matomo 3.x, Internet explorer is supported from version 10 and newer.
In Matomo 4.0 – 4.5, Internet explorer is supported from version 11 and newer.
In Matomo 4.6 and newer Internet explorer including version 11 is no longer supported.

Note that while the Matomo UI works with modern browsers, the Matomo JavaScript Tracker code supports as many browsers as possible. including old and outdated browsers.

Is there a Glossary or lexicon of all terms used in Matomo?

To learn all about the commonly used terms and make the most of Matomo Analytics (formerly Piwik Analytics), check out our Metrics Glossary and Reports Glossary. The Analytics Glossary is available at glossary.matomo.org.

How do I know when new versions are released?

The Matomo (Piwik) Changelog page lists all recent Matomo versions and the list of changes.

The best way to keep track of all new versions is to subscribe to the Changelog Rss Feed. You may also register to our Changelog newsletter here to receive an email whenever there is a new Matomo release.

To stay tuned about the latest Matomo developments, follow the Matomo blog (you can subscribe to our rss feed). If you are interested in technical matters, you may follow our public issue tracker to check our progress, and register with the piwik-hackers mailing list (more info in the developer section). You may also register to our newsletter to receive an update from us a few times a year.

When a new version is released, your Matomo will display a message inviting you to update to the latest version.

Where can I get help and support?

You can find our various help resources in the Matomo Help Centre and also below:

User guides

Our User guides let you discover all features of Matomo and learn how to use them.

Training videos

Become a web analytics expert through our free, short and informative training videos.

Matomo Analytics training videos

Tag Manager training videos


The Matomo Glossary lists the commonly used terms in Matomo Analytics (formerly Piwik Analytics): Metrics and Reports.

Frequently Asked Questions

The FAQs lists the most frequently asked questions and answers.

Developer guides

The Developer Zone is the center of innovation in analytics and guides you to Code, Design & Innovate with the Matomo Analytics (formerly Piwik Analytics) platform.

Free support

Meet other Matomo users and get free support in the Matomo community forums.

Support Plans

We offer annual Matomo Analytics Support Plans intended to assist you to install, configure and optimize Matomo on your infrastructure, as well as troubleshoot and resolve specific issues resulting from the use of Matomo Analytics. Our yearly support subscriptions are best for medium to large businesses and corporate users of Matomo Analytics who need to leverage the full power of the platform and for agencies offering Matomo Analytics services to their customers.

Learn more about our Support Plans or send a message to Support team to get started.

How long is each release of Matomo maintained for?

We maintain Matomo (Piwik) by fixing bugs in new releases, e.g. 2.5.0, 2.6.0, 2.6.1, 2.7.0. We do not support older versions of Matomo nor do we provide patches for older versions of Matomo (except for critical bugs and security bugs in the Long Term Support version – learn more). Please keep your Matomo updated to the latest version to get security updates and new features.

Each newly released version includes many bug fixes and improvements (sometimes even security improvements!). When you use a Matomo version other than the latest stable version and request our help (for example in the forums or paid support), first make sure you upgrade to the latest stable version.

You can download the latest version of Matomo here. The Matomo release lifecycle is explained in more detail in this FAQ.

How much does Matomo cost?

Matomo (Piwik) is a Free Software, released under the GPL license. It does not have a monetary cost (it is free of charge) and the software license ensures it respects your freedom to use and modify the software. If you would like to pay back a little something, you are welcome to participate in the project and spend some of your time and energy to make Matomo better (the app, website or docs). You may also sponsor a new feature or a bug fix.

We are grateful for our wonderful sponsors and the core Matomo team for their amazing work.

Is there any Data Limit in Matomo? Is it possible to keep all historical data?

Please see our Matomo (Piwik) Data Limits Fact Sheet for more information about Data Limits and Historical Data records. In general, Matomo does not believe in any limits, and will only be limited with the server resources. If you have access to existing data, you can also transfer it to Matomo. In particular, you can import old historical visitors data in Matomo.

Does Matomo track visits from Mobile devices (iOS, Android, BlackBerry, Palm Pre, low end mobile phones, etc.)?

For Apps Analytics for an Android App or an iOS app, you can use the iOS SDK and Android SDK to track app sessions, screen views, events, goals, etc.

For a mobile website viewed within a mobile phone browser, when the browser executes Javascript, then Matomo will automatically work and track the site users. This will work for all kind of devices: iOs based devices such as iPhone and iPad, Android based phones or any other modern devices (running Palm Pre, Opera Mobile, Webkit, Mozilla Fennec, etc.).

For low-end mobile devices that use browsers which do not execute Javascript, you can manually record visits using the Matomo (Piwik) Tracking API. Learn more about the Matomo Tracking API. See also Does Matomo track visitors without Javascript?

Can I use Matomo and provide analytics Hosting service? What are the requirements for Matomo Hosted as a service?

It is allowed to re-sell Matomo (Piwik) and provide it for free, or for a fee.

If you are providing a service reusing Matomo, you must also reuse the word Matomo with care. Please see the Matomo Trademark page for more details about how to reuse the name Matomo in your modified version of Matomo. In particular, it is not allowed to use Matomo in the URL domain name.

We would love to know if you create something interesting using Matomo: drop us a message.

We also recommend that you partner with us: we provide the official Matomo Cloud service which you can resell to your customers.

You may also be interested in How to rebrand or sell or reuse or re-license or include Matomo in my product, company, or website?

Matomo provides you the tools to track your website performance and goal conversions, and measure your marketing campaigns on multiple channels.

To get started we recommend to:

  1. Create Goals for all important actions you want your users to take to measure conversions on your website.
  2. Use the URL builder to generate links for landing pages for your email links, paid ads landing pages.
  3. Use the Campaigns report to understand how campaigns perform overall, how each campaign generates conversions, and which campaigns help you grow.
  4. Use the multi channel attribution report to understand how each channel contributes to your goals and how they impact conversions, when you get visits from many channels at once (SEO, campaigns, social, other websites…).
  5. Measure the performance of each email you send easily and measure people who click in links in newsletters.
  6. Use the Advertising Conversion Export so you no longer need to put the tracking code for third party ad networks into your site. Your Matomo goal conversion data will be sent back to Google Ads, Microsoft Advertising or Yandex Ads.

If you run Google Ads, see how to track Google Ads campaigns with Matomo.

What options are available for Single Sign On (SSO) for Matomo?

We currently offer two options for SSO in Matomo:

  1. SAML support for Matomo (Piwik). Allows users in any Identity Provider such as OneLogin, Okta, Ping Identity, ADFS, Google, Salesforce, SharePoint, to log in to Matomo. Purchase LoginSaml plugin on the Marketplace, or learn more in the user guide and FAQs.
  2. LDAP support for Matomo. Allows users in LDAP or Kerberos SSO to log in to Matomo. Also supports web server authentication. Download LoginLdap from the Marketplace.

How can I sponsor a bug to be fixed, or pay for a new feature to be created?

If you are missing some functionality in Matomo (Piwik), need a particular bug to be fixed or if you have any other custom requirements: you can sponsor the development of it.

-> To get started please fill in the Development form.

After you send in the form below we will check the requirements and will email back with a minimum cost estimate. This is to make sure the expectations of the work that is involved are realistic.

If the minimum estimate matches your expectations we will work on a detailed estimate. If you accept the detailed estimate we will give you an estimated release date and start the work.

As soon as your custom plugin, feature or bug fix is ready, we will inform you.

Can I rebrand or sell or reuse or re-license or include Matomo in my product, company, or website?

Reusing Matomo in any way is allowed as long as you respect the GPL license and the Matomo Trademark guidelines. Below you will find more information and pointers.

Using Matomo to track users in your commercial website or apps

You are free to embed any Matomo tracking code or SDK into any commercial or non commercial website, intranets, web apps or mobile apps or any other platform. The Matomo JavaScript Tracker is released under the New BSD license and other Matomo SDKs are released under similar permissive licenses.

The Matomo trademark

Please see the Matomo Trademark page for more details about how to reuse the name Matomo in your modified version of Matomo.

Selling Matomo related services

When you sell Matomo related services to businesses, you just need to make sure you respect the Matomo Trademark rules and the software licenses. We encourage you to provide Matomo related services to businesses in your country or region. For example many Matomo experts provide technical services for Matomo such as helping setup Matomo On-Premise for customers. Analysts and agencies also provide web analytics & growth services to help customers who use Matomo, make the most of their reports and find the best ways to grow their businesses.

Reselling Matomo with a custom branding (white labelled)

When you resell Matomo (Piwik) to customers, you may be interested in our White Label product which removes all the branded aspects of Matomo and lets you provide an immersive experience and your own custom brand.

Reselling Premium Features for Matomo to customers

If you are reseller, and your customers want to purchase premium plugins through your reseller business (instead of purchasing directly from the Matomo Marketplace), this is possible. Please reach out to the Support Team so we can provide the guidelines on how we work with resellers.

Customising Matomo sourcecode

When your product, software, or website uses Matomo but all the code (including your modifications) stays within your company or server, you have the freedom to keep your code and not be bound to the GPL License. For example, you can change the header and footer to reflect your brand, change the colors, or add new features and plugins on your own copy of Matomo.

Selling or distributing the sourcecode

When you distribute a modified version of Matomo, or a software that includes Matomo as a module, then you must give access to the code source and publish all the code under the GPL. You may want to learn more about the GPL License and look at the GPL FAQ.

Distributing a custom plugin for Matomo

You are allowed to create and sell plugins for Matomo. When you create and distribute a new custom plugin built for Matomo, as a Plugin developer it is allowed to release the plugin under a different license than GPL, as long as the plugin is distributed separately from the Matomo platform. For example some third party plugins from our open Marketplace may be released under a different license than GPL. Similarly individual components, libraries and plugins within a Matomo instance may be available for reuse under a different license. Please refer to the LEGALNOTICE file included in the distribution.

Help us make Matomo better

If you modify Matomo and add new features or fix existing bugs, please submit your improvements back to the Matomo team. Together we will build the best Free/Libre open analytics platform!

If you have any other questions or feedback about reselling Matomo Analytics to your customers, send us a message.

Does Matomo work on high traffic websites? What is the performance like with millions of pages views per month?

Matomo (Piwik) can scale to millions of page views per month and/or to thousands of registered websites. If you have a few hundreds visits/page views per day, Matomo should work fine « out of the box ».

Learn more about Matomo requirements and server sizing (capacity planning).

If you have thousands of page views per day or more, click here to view the High Traffic Matomo Guide: Scale & Optimize – or sign up to a 30 day free trial of Matomo Cloud (formerly Piwik Cloud) and get the experts to manage all the technicalities for you!

Can I customize the Matomo logo and favicon in the reports, emails and login screen?

Matomo (Piwik) allows to upload your custom logo and/or favicon which will be displayed everywhere the normal Matomo logo/favicon display:

  1. top of the screen in the Analytics reports,
  2. Login screen,
  3. Emails & PDF Reports.

To upload a Custom Logo in Matomo, login as the Super User, click on Administration > General Settings > Branding, and click on « Use a custom logo ».

If you are interested to customise Matomo further, see our Matomo White Label offer.

Can I get the data from the Matomo API web services and publish, reuse, process this data in a non GPL software?

Yes, the data coming from the Matomo (Piwik) API belongs to you and is not covered by the GPL.

You can use Matomo as a service, and reuse, publish, display, modify, process the data coming from the Matomo API using the REST API web services call. See also the GPL FAQ: Is there some way that I can GPL the output people get from use of my program? For example, if my program is used to develop hardware designs, can I require that these designs must be free?

Does Matomo work in a load balanced environment? Multiple servers high scale tracking

Many medium-high traffic websites successfully use Matomo (Piwik) to track and analyse their website behavior and performance. See this FAQ for general information about high traffic Matomo.
If you want to provide high reliability and better performance in your Matomo setup, you can load balance Matomo services on various servers. It is pretty easy to do so, but make sure you read the following documentation.
Matomo stores all tracking data, reports, users, settings, etc. in the shared mysql database. Matomo also needs to read/create files to store information, caches, temporary files:

  • config/config.ini.php is used by every request to Matomo. It contains db access, plugins enabled, various settings, etc. The file is only modified when the Super User changes some settings in the Admin interface (activating plugins, changing smtp settings, etc.). This file must be synchronized on every Matomo server.
  • tmp/* contains temporary and cached files such as: compiled templates, generated PDFs, tracking caches, etc. This directory tmp/ content can be safely deleted and Matomo will automatically recompile templates and recreate caches.
  • by default, Matomo uses file session storage, which are usually stored in tmp/sessions, or in the global sessions directory (see php.ini). There is a config setting to enable database session storage, see this faq

When Matomo is used behind a load balancer, here are the steps to follow:

  1. synchronize config/config.ini.php on all servers – make sure the file config/config.ini.php is the same on all servers (using rsync for example).
  2. upload all the Matomo files and all plugins to all servers, as it is important that all your servers run the same codebase with all features, including any free or premium plugin from the Marketplace.
  3. enable database session storage (If you use 3.7.0 or later it should already be enabled by default)
  4. in your config.ini.php, below the section [General], add the following line: multi_server_environment=1. This setting lets Matomo know you’re using multiple servers and for example it will then not allow the installation of a plugin via the UI (or the plugin would be only installed on one server), or it will not allow config file changes from the UI (as the config file would be updated on one server only).
  5. we highly recommend to enable SSL in Matomo

Matomo should then work as expected in a load balanced environment. For example, a common way to load balance Matomo on 3 servers: Load balancer in front of (2x) webservers which are tracking/querying the (1x) Master mysql DB server. For further optimization, a (1x) UI webserver can be added, to handle all API requests, UI requests, and run the cron archiving. This server can also be doubled and load balanced.

Typically, webserver boxes would be cheap to operate (trackers, frontends and archivers), and the Master DB server would be larger (eg. multiple cores, 16G memory, fast disk access), which could scale to a certain point (100M hits per month is achievable and some users even track around 1 billion hits per month). Get expert support and help from the Matomo team.

Learn more: How to configure Matomo for speed.

If your load balancer is used as a SSL proxy, make sure to read our FAQ: How do I configure Matomo when the server is installed behind a proxy?

Has Matomo won any Award?

The Matomo (Piwik) team is honoured and grateful to have won several awards over the years, in recognition of building the leading open source web analytics platform used by more than 1,000,000 websites worldwide.

Learn more about our Awards for Matomo: the open analytics platform.

Where does the name Piwik come from?

As you may know before being called Matomo, for 10 years the project was called Piwik! When working on the first version of Piwik, Matthieu was looking for a name that was unique, easy to remember, easy to pronounce, with as few letters as possible, and for which the domain name was still available. After a few hours of deliberation and creative thinking, and becoming inspired by the word « kiwi », the name « Piwik » was born. The name ‘Piwik’ does not have a particular meaning, but we are on a mission: « To create, as a community, the leading international open source web analytics platform, that gives users full control of their data. »

Piwik PRO vs Matomo (Piwik PRO VS Piwik)

  • Matomo (formerly Piwik) and Piwik PRO are independent from each other and separate entities.

  • Piwik PRO is not contributing anything to the Matomo (formerly Piwik) project.

  • Piwik PRO is a business entity in Poland.

  • There is absolutely no Piwik PRO employee or people who are part of the Matomo core team or who have any commit access to Matomo.

  • About the trademark: Piwik PRO owns the « Piwik PRO » trademark which was acquired from Matthieu Aubry, « Piwik » trademark owner.

  • Matomo is created and offered to you by InnoCraft and the Matomo team.

Piwik was founded by Matthieu Aubry in 2007, and renamed to Matomo in 2018. The Matomo project is maintained by the Matomo core team and the community at large. Anyone can get involved and join our team.

The founder of Piwik and Matomo along with the core engineers founded InnoCraft, providing enterprise-level web analytics to governments and businesses requiring full privacy compliance and 100% data ownership. InnoCraft also offers powerful premium products for Matomo as well as a Matomo Analytics Cloud service.

By using InnoCraft you will benefit from our higher quality products and services perfectly integrated into Matomo. For example we offer Form Analytics, Media Analytics, Heatmaps, Session Recording, and many more outstanding premium features. In terms of services we offer Support subscriptions, GDPR compliance solutions, Personalised user trainings, Matomo Enterprise, and more.

When you work with InnoCraft, you are directly supporting the Matomo project.

Contact the official Matomo support team here. We recommend that you work exclusively with the official Matomo team at InnoCraft for getting the best services and results.

If you have any other question, feel free to contact us.

How do I pronounce Matomo?

If you’re wondering how to say ‘Matomo’, you can find out by clicking play:

Who is InnoCraft?

InnoCraft are the creators and makers of Matomo. Our team of Matomo experts emphasise quality customer service and strive to build strong personal relationships with our customers.

We know that every business has different needs, structures and goals. Our services and solutions for the open digital analytics platform Matomo are designed to make sure you can use Matomo to its full potential and achieve your goals in the smartest way possible.

We help our customers get started, configure, monitor and make the most of their Matomo Analytics service. To achieve this, we offer a set of unique analytics products and services that help grow businesses worldwide, and can meet the needs of small, medium and large businesses alike:

Our offices are located in New Zealand and our Matomo Cloud service is hosted in Europe. We believe in openness, privacy and 100% data ownership. Our mission is to liberate analytics and we are passionate about measuring for success. Our co-founders are Matthieu Aubry (Matomo founder, originally from France) and Thomas Steur (Matomo lead developer, originally from Germany).

Have any questions? Get in touch with us

Who is the team behind Matomo?

Matomo (Piwik) is a Free/Libre collaborative effort with many people contributing to the project to make Matomo what it is today. Visit the Matomo Team page to view profiles. You can also be part of the Matomo project! We need help to build the best open source web analytics software, and there are many ways to help whether you are a Matomo user, a developer, a marketing fan, a blogger, or if your native language is not English and you want to translate the software. We hope you will join us! Check out Getting involved in Matomo.

Where do I find Video Tutorials teaching how to use Matomo?

The Matomo (Piwik) community has created a free online video training program as well as a few short Videos that aim to explain how to install, configure, and how to use Matomo advanced web analysis tools. Check out the following videos:

Is Matomo Analytics HIPAA compliant?

The Health Insurance Portability and Accountability Act (HIPAA) is a US regulation developed to protect the privacy and security of certain health information. Matomo Analytics is used by many companies in the healthcare industry building medical and health related applications. Matomo can be configured in a way that it is compliant with HIPAA.

When should I care about HIPAA?

When you collect any protected health information (PHI) using Matomo for example via user id, custom dimensions possibly storing health data, urls, page titles, session recordings that may record personal data, or even other PII… then you may need to be compliant with HIPAA in the US (and other privacy regulations like GDPR).

To be compliant with HIPAA you will need to follow these steps at least:

  • Download and install Matomo on infrastructure and servers you own or lease from a HIPAA compliant webhosting company. (The official Matomo Cloud service is not HIPAA compliant.)
  • Partner with web hosting companies that are HIPAA compliant and have processes for protecting PHI and your Matomo.
  • Sign a business associate contract (BAA) with any third-parties that have access to your patients’ PHI. (You won’t need to sign the BAA document with us at Matomo since we don’t host your data and we cannot access it.)
  • Encrypt your Matomo database with data encryption at rest in MySQL/MariaDB.
  • Establish processes to delete, backup and restore encrypted PHI and Matomo database as needed
  • Setup SSL certificate for all your websites and apps
  • Setup SSL certificate for your Matomo server
  • Ideally implement a secure SSL Database connection between Matomo web server and your MySQL/MariaDB database server.
  • Use Activity Log to keep track of changes done to Matomo entities.
  • Send Matomo emails (some which may contain PHI) through encrypted email servers
  • Ensure that PHI and Matomo interface and API is only accessible to authorized individuals

If you have any question or if you need help with your Matomo On-Premise setup contact us, we’re always happy to help.

Source used: fullmedia.com/a-beginners-guide-to-hipaa-compliant-websites

Is Matomo Analytics CCPA compliant?

Matomo Analytics and Matomo Tag Manager ensures full compliance to the California Consumer Privacy Act (CCPA) and other privacy laws worldwide. Below you will learn more about CCPA, whether it applies to your business, and how you can get CCPA compliance for Matomo Analytics.

What is CCPA?

The California Consumer Privacy Act (CCPA) is a law which lets California consumers see all of the personal data a company has collected and saved about them. The law also lets people sue the companies that have violated their privacy.

It is intended to enhance privacy rights and consumer protection for residents of California, United States. The CCPA became effective on January 1, 2020.

California residents worldwide are now provided with the right to:

  • Know what personal data is being collected about them.
  • Know whether their personal data is sold or disclosed and to whom.
  • Say no to the sale of personal data.
  • Access their personal data.
  • Request a business delete any personal information about a consumer collected from that consumer.
  • Not be discriminated against for exercising their privacy rights.

When should I care about CCPA compliance?

Any company or business that collects consumers’ personal data from California residents should comply with the CCPA, if they also satisfy at least one of the following thresholds:

  • Buys, receives, or sells the personal information of 50,000 or more consumers or households; or
  • Has annual gross revenues in excess of $25 million; or
  • Earns more than half of its annual revenue from selling consumers’ personal information.

How do I check if my business collected personal information on more than 50,000 California residents?

If you’re already using Matomo Analytics, you can check whether you have collected more than 50,000 visitors from the California region. In Matomo, select the last year in the calendar, then go to Visitors > Locations and under the « Region » report, you can search for « California ». You will then see how many visits you got from California in the last year. If you got more than 50,000 visits, you will know you very likely need to comply with CCPA.

To be compliant with CCPA and Matomo Analytics you will need to follow these steps:

We recommend you work with your legal team to review your CCPA compliance.

If you have any question or if you need help with your Matomo On-Premise setup contact us, we’re always happy to help.

Source used: CCPA (Wikipedia)

How do I install Matomo Analytics tracking code in a Jimdo website?

Have you ever wondered how to integrate Matomo Analytics with your Jimdo site. Integrating Matomo will help you get the insights of visitors behaviour on you website and increase the conversion.

You will need Matomo (Cloud or On-Premise) and Jimdo.

Integrate Matomo Analytics to your Jimdo website

  1. Login to Jimdo Dashboard and you should be able to see your website if you already have one created
  2. Click on « Edit »
  3. Click on « Menu » on the top left
  4. Click on « Settings »
  5. Click on « Edit Head »
  6. Copy the Tracking code of your website by following the steps below:
         a. Login to Matomo
         b. Click on “Admin (cog icon)” on the top right of your dashboard
         c. Click on “Manage” under “Measurables”
         d. Click on “View Tracking Code”
         e. Scroll down and Copy the JavaScript tracking code and paste it in your Jimdo website
  7. Click on « Save »
  8. Open your website in the browser and perform some actions (eg: navigate to different pages)
  9. Log in to your Matomo and check if you’re able to see the data

Congratulations, you should now be successfully tracking visitors with Matomo Analytics through your Jimdo site.

Happy Analytics!

Is Matomo Analytics PIPL Compliant?

The Personal Information Protection Law (PIPL) was passed on 20 August 2021. The PIPL is a China data protection law that takes effect from 1 November 2021. This is an important change for all organisations and individuals who process personally identifiable information (PII) of people in China. Importantly, Matomo Analytics can be configured in a way that is compliant with PIPL.

What does PIPL consider as personal information?

The PIPL defines “personal information” as all kinds of information relating to identified or identifiable natural persons recorded by electronic or other forms, excluding anonymised information. “Processing of personal information” includes, among other things, the collection, storage, use, refining, transmission, provision, public disclosure and deletion of personal information. The concept of “personal information” in PIPL is similar to “personal data” in GDPR.

When does the PIPL apply?

  • If you are processing PII within China; or
  • You are outside China and process PII of a person who is inside China, if the processing is:
    1. for the purpose of providing products or services; or
    2. to analyse or evaluate the behaviour of an individual

When should I care about PIPL?

When you collect any personally identifiable information (PII) using Matomo for example via user id, custom dimensions possibly storing user data, urls, page titles, session recordings that may record personal data, or even other PII, then you may need to be compliant with PIPL (and other privacy regulations like GDPR).

Are there penalties for PIPL non-compliance?

Yes, breaching the PIPL may lead to a fine of up to RMB 50 million or 5% of the processor’s turnover in the last year.

To be compliant with PIPL you will need to follow these steps:

If you have already done the steps to be GDPR compliant and followed the 12 steps to make Matomo compliant with GDPR then you have done the bulk of the work.

Most of the same steps also apply for PIPL compliance:

  • Add a privacy notice.
  • Add Matomo to your privacy policy page.
  • Choose a lawful basis for processing personal data. The PIPL does not provide “legitimate interests” as a lawful basis for processing as found in the GDPR, and you may need to collect consent from users.
  • Consent may need to be obtained from users in China before collecting their personal information or tracking them. (The consent must be informed, freely given, demonstrated by a clear action of the individual, and may later be withdrawn via opt-out).
  • If you are processing any sensitive personal information, or personal information for automated decision-making, or if you are sharing personal information with third parties then you need to make a Data Protection Impact Assessment, and retain the processing records for at least three years for these following processing activities.
  • Download and install Matomo on your infrastructure and servers, or from a secure web hosting company such as Matomo Cloud. Ensure that PII and Matomo interface and API is only accessible to authorised individuals

If you have any questions or if you need help with your Matomo On-Premise setup contact us, we’re always happy to help.

Sources: PIPL and how to compares to GDPR (IAPP) and PIPL: A game changer for companies in China, Norton Rose

How do I install the Matomo tracking code on SquareSpace?

If you want to integrate Matomo Analytics with your Squarespace website to get valuable insights, you’re in the right spot. To get awesome analytics for squarespace with Matomo, follow the steps below to get you set up in minutes.

You will need Squarespace plan (Business or Commerce) and Matomo (Cloud or Self-hosted).

Integrate Matomo with Squarespace website

  1. Login to Squarespace, you will be able to see the list of websites
  2. Click on the website which you want to track
  3. Click on “Settings” on the left menu
  4. Click on “Advanced > Code Injection”
  5. Copy Matomo JavaScript Tracking Code and paste it in “Header” text area
    Follow the steps below to copy tracking code:
    a. log in to Matomo with your admin or Super User account
    b. click on « Administration (cog icon) » on the top right of your dashboard
    c. click on « Tracking Code » under « Measurables » in the left menu
    d. choose the website from the dropdown
    e. copy the Tracking code

6. Click on “Save”
7. Open your website in the browser and perform some actions (eg: navigate to different pages)
8. Login to Matomo and check if the website is tracked

Congratulations, you are successfully tracking your visitors on your Squarespace website. Happy Analytics!

How do I install the Matomo Analytics tracking code on Joomla?

Joomla is one of the popular Content Management Systems, have you ever wondered how to integrate Matomo Analytics with your Joomla site. Integrating Matomo will help you get the insights of visitors behaviour on you website and increase the conversion. « nfrPiwik » plugin helps you to add Matomo Tracking code in to your Joomla site with ease.

You will need Matomo (Cloud or On-Premise) and Joomla.

Integrate Matomo Analytics to your Joomla website

Follow the steps below:
1. Download « itcs Matomo plugin » plugin and extract it to « /tmp » folder inside Joomla directory and rename the folder to « itcs Matomo Plugin »
2. Log in to Joomla Administration
3. Hover over “Extension” from the top menu bar
4. Hover over “Manage” and click on “Install”

5. Click on “Install from folder”
6. Click on “Check and Install”

7. Make sure the folder “Joomla/plugins/system” is writable by your web server as the plugin will need to create a folder in this location
8. Once the installation is successful, hover over “Extension” from the top menu bar
9. Click on “Plugins” and enter “itcs Matomo Plugin” in the search
10. Select “itcs Matomo Plugin” and click on “Enable” on the top

11. Copy the Tracking code of your website by following the steps below:
     a. Login to Matomo
     b. Click on “Admin (cog icon)” on the top right of your dashboard
     c. Click on “Manage” under “Measurables”
     d. Click on “View Tracking Code”
     e. Scroll down and Copy the JavaScript tracking code
     f. Paste the Tracking code in “PLG_MATOMO-ANALYTIC_CODE” field

12. Click on “Save & Close”
13. Open your website in the browser and perform some actions (eg: navigate to different pages)
14. Log in to your Matomo and check if you’re able to see the data

Congratulations, you should now be successfully tracking visitors with Matomo Analytics through your Joomla site.

Happy Analytics!

How do I install the Matomo tracking code on WordPress?

Matomo for WordPress

There’s a Matomo Analytics WordPress plugin called Matomo Analytics – Ethical Stats. Powerful Insights. This plugin let’s you very easily and quickly install Matomo Analytics fully in your WordPress. This plugin is recommended for websites of up to 50K page views/month when you don’t already use Matomo On-Premise or Matomo Cloud.

But if you are already using Matomo on our Cloud or On-Premise, then you have to use the WP-Matomo Integration (WP-Piwik) plugin to set up the tracking code see the instructions below in the next section.

For Matomo for WordPress, follow these instructions:

  • Install Matomo for WordPress
  • To set up the tracking code in Matomo for WordPress simply go to the « WordPress Admin -> Matomo Analytics -> Getting started » page and click on « Enable tracking now ». Alternatively, set the tracking code to « Default tracking » in the « WordPress Admin -> Matomo Analytics -> Settings » page and click on « Save changes ». That’s it. The plugin will put the tracking code automatically into your site. You can optionally configure the tracking code to your liking on the Settings page if you wish.

WP-Matomo Integration (WP-Piwik) – When you use Matomo On-Premise or Matomo Cloud

WP-Matomo Integration (WP-Piwik) plugin uses the Matomo API to show your Matomo statistics in your WordPress.com or self-hosted WordPress dashboard. It’s also able to add the Matomo tracking code to your blog and to do some modifications to the tracking code. Additionally, WP-Matomo Integration (WP-Piwik) supports WordPress networks and manages multiple sites and their tracking codes. This plugin needs to be configured for it to work with Matomo.

You’ll need Matomo (Cloud or Self-hosted) and WordPress (WordPress.com or Self-hosted using WordPress.org).

Integrate Matomo Analytics to your WordPress website

To configure the plugin, follow these steps:

  1. Log in to your WordPress site as the administrator

  2. Click on « Plugins » from the left menu

  3. Search for « WP-Matomo » and click on « Activate »

  4. In the left menu, click « Settings » > « WP-Piwik ». The WP-Matomo Settings page appears

  5. Click on « Connect to Matomo » tab, and in the « Matomo Mode » dropdown, choose the option « Self hosted (HTTP API, default) ». In the « Matomo URL » text field, enter your Matomo URL for example analytics.example.com.

  6. If your Matomo is cloud hosted select Cloud-hosted (*.matomo.cloud or *.innocraft.cloud) from the Matomo mode drop down, then enter your subdomain in the Matomo subdomain field. For example if your cloud domain is mysite.matomo.cloud, just enter mysite in this field.

  7. In the « Auth token » text field, type your Matomo authentication token. How to find Auth Token

  8. Confirm the « Auto config » checkbox is selected and click on “Save Changes”

  9. You should see « WP-Matomo is successfully connected to Matomo » message. If you do not see the message, make sure the values you provided in steps 5 to 7 are correct, and then try again

  10. Click on « Enable Tracking » tab

  11. In the « Add tracking code » dropdown, select « Default tracking »

  12. Click on “Save Changes” and a success message will appear

  13. Open your website in the browser and perform some actions (eg: navigate to different pages)

  14. To view Matomo statistics for your site, in the left menu, click on Dashboard, then click WP-Piwik. The Matomo Statistics page appears with visitor statistics, site search statistics, and more. To view all the detailed reports please login to your Matomo instance

Congratulations, you should now be successfully tracking visitors with Matomo Analytics through your WordPress site! Happy Analytics.

What is the difference between RAW data and report data?

When we talk about data in Matomo we often refer to RAW data, and the report data. Here we discuss the difference between these data types.

RAW data (unprocessed data)

RAW data is the tracking information gathered from your site and stored in your Matomo database. Each time a visitor visits your site, tracking information is sent to Matomo. The tracking request sent to Matomo looks like this:


This HTTPS request contains all the relevant information about your visitor like the page URL, page title, browser type, device, visit time plus much more depending on the request. Learn more in FAQ: what data does Matomo track?

This data is split up and then stored in your Matomo database. As you can imagine with thousands or millions of visits this can consume a lot of space. The data is then archived and aggregated into report data. After this has happened the RAW data is usually redundant as the relevant information is now in the report data. However the RAW data is still used when you create segments of your users. You can configure Matomo to delete old RAW data (unprocessed data).

To view the RAW data in Matomo, go to Matomo > Visitors > Real-time. Other reports such as heatmaps and session recording also rely on RAW data.

The simplest description is you can consider the RAW data the the raw material of a cake, flour, eggs sugar etc.

Report data (archived data)

Report data (the cake) is derived from your RAW data. Once the reports are created and the RAW data has been removed it is not possible to deconstruct the report data to create RAW data. However, Matomo can keep the report data forever. RAW data could potentially be kept forever also but due to the amount of space this would require it is not entirely practical and generally not required.

Report data can be found in the reports in the Matomo left hand navigation menu (most left menu links will show report data).

You can configure Matomo to delete old Report data (archived data).

What issues arise if the RAW data is not available?

Please see the section in this FAQ called: What is the impact of deleting historical RAW data?

How do I install the Matomo code on Webflow

Webflow is a web design tool, CMS, and hosting platform. The Matomo tracking code will need to be added to your Webflow site via the embed code element. Webflow allows you to add the tracking code sitewide or per page. We will discuss both methods below.

You will need a paid webflow.com account and your Matomo instance (Self-hosted or Cloud).

Integrate Matomo with Webflow (site wide)

1.Copy Matomo Tracking Code, follow the steps below:
a. Login to Matomo
b. Click on “Admin (cog icon)” on the top right of your dashboard
c. Click on “Manage” under “Measurables”
d. Click on “View Tracking Code”
e. Scroll down and copy JavaScript tracking code
2. Login to your Webflow designer.
3. Select Project settings from the top left nav menu.

4. Select Custom Code from the horizontal nav bar.

5. Paste your tracking code into the Head Code textbox.
6. Click save changes.
7. Publish the changes.
8. Login to Matomo and check if the page is tracked in the report Visitors > Visits log.

Integrate Matomo with Webflow (per page)

You may want to run specific tracking requests based on the page your visitor is on. For example an event to trigger a goal.

Please use the procedure below to achieve this.

  1. Login to your Webflow designer.
  2. Choose the pages icon from the left nav menu.
  3. Click the gear on the page you want to add the code to.
  4. Scroll down the right-hand panel to Custom Code
  5. Add any additional page specific code. For example, you may want to add an event on this page.
    NOTE: Typically you would not add the tracking code here as well as site wide.
  6. Publish the changes.
  7. Login to Matomo and check if the page is tracked in the report Visitors > Visits log.

Congratulations, you should now be successfully tracking your visitors on your Webflow website. Happy Analytics!

How do I install the Matomo tracking code on my Shopify store?

Shopify is a popular online ecommerce store. Before Matomo can start tracking your store, you will have to manually add the tracking code. This only needs to be added once.

Currently Matomo does not have an eCommerce integration with Shopify, so Ecommerce tracking is not available. That’s because Shopify plans don’t allow 3rd party javascript on their checkout pages, so Matomo cannot track these ecommerce checkout pages. Still your analytics reports for Shopify will be very detailed with all the useful data that Matomo will collect and report about your users and their interactions on your site.

You’ll need a Shopify.com account and your Matomo instance (Self-hosted or Cloud).

Integrate Matomo Analytics into your Shopify Store

  1. In Matomo, copy your Matomo tracking code. You will find your tracking code in Admin > Measurables > Manage > View Tracking code
  2. Login to your Shopify store. Select Online Store, then chose Themes from the dropdown menu. Select Edit Code from the Actions menu.
  3. Select theme.liquid from the Layout.
  4. Scroll down to where you can see </head> in the code. Immediately above this, paste your Matomo tracking code (Step 1).
  5. Click Save from the top right of the window.
  6. (optional step) If you have Shopify Plus (Shopify enterprise version), reach out to your Shopify Merchant Manager who will be able to install Matomo in your checkout pages.
  7. Open your website in the browser and perform some actions (eg: navigate to different pages)
  8. Login to Matomo and check if the website visit is tracked

Congratulations, you should now be successfully tracking your visitors on your Shopify store. Happy Analytics!

How do I install the Matomo Analytics tracking code on Wix?

Wix is one of the popular Content Management Systems to create websites which you may be using. Have you ever wondered how to track your Wix website’s visitors behaviour with Matomo Analytics. Follow the steps below and start measuring your visitors with Matomo and get valuable insights into your Wix website in minutes!

You’ll need a Wix.com account (at least Premium plan) and your Matomo instance (Self-hosted or Cloud).

Integrate Matomo Analytics in a Wix website

To add Matomo tracking code to Wix please follow the below steps:

  1. Login to Wix and you will be redirected to your dashboard

  2. Hover over the site where you want to add Matomo tracking code and click on « Select & Edit site »

  3. Click on « Settings » on the left menu

  4. Scroll down and click on « Advanced > Custom Code »

  5. Click on « Add Custom code »

  6. Copy Matomo Tracking Code, follow the steps below:
    a. Login to Matomo
    b. Click on « Admin (cog icon) » on the top right of your dashboard
    c. Click on « Manage » under « Measurables »
    d. Click on « View Tracking Code »
    e. Scroll down and copy JavaScript tracking code

  7. Paste Matomo tracking code in the text box called « Paste the code snippet here »

  8. In the « Name » field you can name this code snippet for example: Matomo

  9. In the « Add Code to Pages » please choose the suitable option for example: if you want to add code to « All pages » or « choose specific pages »

  10. In the « Place Code in » option choose where to place the Matomo tracking code in your website. We recommend adding the code in the « Head ».

  11. Click on « Code Type » on top of the « Add Custom Code » Window, choose the appropriate type

  12. Click on « Apply »

  13. Open your website in the browser and perform some actions (eg: navigate to different pages)

  14. Login to Matomo and check if the website is tracked

Congratulations, you should now be successfully tracking your visitors on your Wix website. Happy Analytics!

How do I install the Matomo tracking code on my GoDaddy Website Builder pages?

GoDaddy provides a Website Builder that lets you create your own websites. Have you ever wondered how to integrate Matomo Analytics with your GoDaddy Website Builder pages? Integrating Matomo will help you get the insights of visitors behaviour on you website and increase your conversions.

You can add the tracking code manually with some modifications. The code is installed on the site using an iFrame so advanced javascript functions like heatmaps and session recordings are not available.

You will need Matomo (Cloud or On-Premise) and your Godaddy account.

Integrate Matomo Analytics to your GoDaddy Website Builder

Follow the steps below:

  1. Login to your Matomo edit the configuration of your website Admin > Manage > Measurables. Select your site and add your site URL to the list URLs in your measurable.
  2. Go into your site editor and select Add section from the right navigation bar.
  3. Select HTML and Add
  4. Click on the new section then click in the text box in the right hand nav bar.
  5. Paste the following code. Swap example.matomo.cloud with your own Matomo server and enter the correct site id.

<script type="text/javascript">
var _paq = window._paq || [];
/* tracker methods like "setCustomDimension" should be called before "trackPageView" */
_paq.push(['setDocumentTitle', window.parent.document.title]);
_paq.push(['setCustomUrl', window.parent.location])
(function() {
var u="https://example-replace-me.matomo.cloud/";
_paq.push(['setTrackerUrl', u+'matomo.php']);
_paq.push(['setSiteId', '9']);
var d=document, g=d.createElement('script'), s=d.getElementsByTagName('script')[0];
g.type='text/javascript'; g.async=true; g.defer=true; g.src='//example-replace-me.matomo.cloud/matomo.js'; s.parentNode.insertBefore(g,s);
<!-- End Matomo Code -->

  1. Click Publish

Congratulations, you are successfully tracking your visitors on this particular page.

To add the tracking to more pages or all your pages, you will need to complete this procedure for each page you want to track. (Unfortunately at this time this is the only solution we know of).

Happy Analytics!

How do I install the Matomo tracking code on Drupal?

At times it can be hard to integrate Analytics tools into your CMS like Drupal. Matomo Analytics module makes it easy to add Matomo tracking code into your Drupal website and start tracking your visitors behaviour instantly. Even the users who don’t have any technical experience will be able to achieve this with ease.

You’ll need Matomo (Cloud or Self-hosted) and Drupal.

Note: This guide is written in an assumption that you have already installed Matomo Analytics for Drupal module in your website

Integrate Matomo Analytics to your Drupal site

To configure the plugin, follow the steps below:

  1. Download the Matomo Module for Drupal

  2. Open Drupal Administration page

  3. Click on « Extend » on the top menu bar

  4. Click on « Install new module » and choose the downloaded module and click on « Install ».

  5. Search for Matomo in the search bar, you will be able to see the module if it is installed properly

  6. Click on the small arrow on the right side of the name Matomo Analytics

  7. Click on « Configure »

  8. Enter the siteId in the « Matomo Site ID » field. How to get site ID?

  9. Enter your Matomo instance URL (ex: https://example.matomo.cloud/) in « Matomo HTTPS URL », make sure ‘/’ is added at the end

  10. If you would like to add some Custom JavaScript code to your Matomo Tracking code, you can do so under « Advanced Settings > Custom Snippet »

  11. Scroll down to the bottom at Click on « Save Configuration »

  12. Open your website in the browser and perform some actions (eg: navigate to different pages)

  13. Login to your Matomo instance to check if you’re getting the tracking data of your site

Congratulations, you should now be successfully tracking visitors with Matomo Analytics through your Drupal site! Happy Analytics.

How do I use Matomo Analytics within GTM (Google Tag Manager)?

You can use Matomo with Google Tag Manager.

To setup Matomo Tracking in Google Tag Manager, follow these steps:

  1. Go to Google Tag Manager
  2. Click « Tags » and then « New ».
  3. Click « Tag Configuration » and select « Custom HTML »
  4. Copy the standard Matomo JavaScript Tracking code:
    • log in to Matomo with your admin or Super User account
    • click on the « administration » (cog icon) in the top right menu
    • click on Tracking Code in the left menu (under the « Measurables » or « websites » menu)
    • click on Tracking Code in the left menu
    • click on « JavaScript Tracking » section
    • select the website you want to track
    • copy the tracking code
  5. Paste this JavaScript tracking code in the Tag Configuration HTML field.
  6. Finally you need to define a trigger on Pageview to trigger this custom HTML Tag and record your users pageviews:
    • Click « Triggers » and then « New ».
    • Click « Trigger Configuration » and choose « Pageview ». This will fire the Matomo Analytics tracking code when the web browser begins to load a page.
  7. Then Publish the current container’s workspace to make these changes live in your website.
  8. Open your website in the browser and perform some actions (eg: navigate to different pages)
  9. Login to your Matomo instance to check if you’re getting the tracking data of your site

To learn even more about using Matomo with GTM, we recommend this 3rd party article: Google Tag Manager and Matomo.

Did you know? Matomo also has its own Tag Manager, learn more about the Matomo Tag Manager.

How do I integrate Matomo data with a Customer Data Platform (CDP) or Business Intelligence Tool (BI)?

Matomo collects a lot of interesting user data and structures this data in real-time into individual visitor profiles and general aggregated reports.

Customer Data Platform (CDP)

Matomo can act as a Customer Data Platform (CDP) because Matomo aggregates and organizes user and customer data across a variety of touchpoints. APIs are provided to make it easy to integrate with other software and systems.

But you may be using your own CDP, in which case you can seamlessly integrate Matomo RAW users and interaction data (clickstream) in your CDP by using either the RAW data APIs, or the SQL connector. Learn more how you can make the Matomo Analytics RAW data available to my data warehouse.

Business Intelligence Tool (BI)

You may be using a BI tool like Tableau, Power BI, Looker, Zoho Analytics, QlikSense, Oracle Analytics Cloud.
For integrating Matomo Data with a BI tool, we recommend to look at our guide for Google Data Studio integration, and try and follow a similar process with your BI tool.

Server-side analytics tracking and/or Desktop apps tracking with Matomo

By default, Matomo uses a JavaScript Tracker code to track users who visit a website with their browser. However, using JavaScript is not the only option and Matomo also offers several alternatives. For example, you can use Matomo to get Mobile Apps Analytics for iOS and Android based apps. You can also implement tracking of your users and interactions in your Apps, or APIs, or servers backends using one of the Server-Side tracking libraries. The Matomo team offers SDKs for Apps and Server-Side Analytics in the following languages:

  • PHP
  • Java
  • C#

There are community contributed SDKs in many more languages:

And if for some reason you can’t implement server-side tracking, but you have access to the web server access logs, you can use the Log Analytics tool to import your server-side logs in Matomo! Learn more in Server Logs Analytics and How do I use Log Analytics to import my logs?

Note to developers: if you use any of these SDKs, it is greatly appreciated if you can consider reporting bugs, feature requests, and even open pull requests to help improve these SDKs, in the relevant GitHub issue tracker. Most of these SDKs are built by developers like you from the Matomo community, and we rely on your support to keep the SDKs up to date. The PHP SDK is always the most up-to-date one and the one that you can refer to when implementing a new SDK, since Matomo itself uses the PHP SDK for server-side tracking.

Online radio analytics for IceCast web radios with Matomo

Icecast is a streaming media (audio/video) server which is used to create an Internet radio station or a privately running jukebox and many things in between. It is very versatile in that new formats can be added relatively easily and supports open standards for communication and interaction (currently supports Ogg Vorbis and Ogg Theora, Opus, WebM and MP3 streams).

With Matomo (Piwik) you can get awesome analytics for your IceCast multimedia streams:

  • A community plugin IcecastStatistics lets you connect to Icecast and import key metrics into your Matomo dashboard.
  • We also recommend that you track how people use your Audio player on your website, with the official Media Analytics for Matomo. ​​​​​​​​When you embed your audio file, we recommend you set a title HTML attribute on your <audio> elements so that Media Analytics can detect the media title and give you detailed insights about how users consume your radio. (Get Media Analytics)
  • Finally, if you have access to the IceCast server logs, you may also import the IceCast logs in Matomo using our Log Analytics solution.

How to import Matomo data in to Google Data Studio?

Matomo tracks a lot of valuable data about the behaviour of your website visitors. If you’ve ever wondered about how to visualise the data tracked by Matomo in a third party tool like Google Data Studio then this is the guide for you. In this guide, we are going to take your through the steps to connect your Matomo to Google Data Studio.

With Matomo On-Premises – especially when you have access to the database, it is easy to connect Matomo to Google Data Studio using MySQL connector. The challenge is when you do not have access to the database. Here is the workaround of importing data in Google Data Studio using Google sheets.

Note: Some Matomo reports contain a lot of data that Google sheets may not accept without further modification of the sheet. The code supplied is not supported by Matomo as this is just an example of how to achieve the connection.

If you are using Matomo for WordPress then this guide will not work as Matomo for WordPress doesn’t support the regular Matomo HTTP Reporting API and instead utilises the WordPress Rest API see our WordPress Rest API reference. You may be able to connect Matomo for WordPress by either choosing « MySQL » as a data source or importing the data into a Google Spreadsheet using the WordPress REST API. The « token_auth » feature is not available in Matomo for WordPress.

Creating a script that calls Matomo API and import data in Google Spreadsheets

Matomo API gives you the ability to export all the data into multiple formats. How to export?

In the example below, we’re going to export a Custom report.

1. Click on « Export » icon.

2. Choose « CSV » under « Export Format », choose « All » under « Row Limit », click “Show Export URL” and then copy the « Export URL ».

Important note: The token_auth that you see on this export screen is a session token_auth that will only be valid while you are logged in. Please follow our guide to generate a token_auth.

Once you’ve generated an token_auth, you will need to insert the new token_auth that you created in the URL below, for example: &token_auth=your_new_auth_token_here

3. Open a blank « Google Sheet » and name it appropriately.

4. Click on « Tools > Script Editor ».

5. In the « Script Editor », paste the code find below. The code supplied is not supported nor created by Matomo as this is just an example of how to achieve the connection.

function myFunction() {        
  var csvUrl = "EXPORT_URL";
  var csvContent = UrlFetchApp.fetch(csvUrl).getContentText();
  var csvData = Utilities.parseCsv(csvContent);
  var sheet = SpreadsheetApp.getActiveSheet();
  sheet.getRange(1, 1, csvData.length, csvData[0].length).setValues(csvData);

6. Replace the « EXPORT_URL » in the above code with the URL copied in STEP 2 and append &convertToUnicode=0 at the end of the URL. Note: you can use &date=yesterday if you just want to report on « yesterday’s » data.

7. Append to the « EXPORT_URL » the following URL parameter: &convertToUnicode=0 at the end of the URL.

8. Rename the Project and click the save icon.

9. Click on the Run icon and when prompted, proceed and give the script authorisation to connect to an external service.

10. Data should be imported in the Google sheets at this instance. You would need to run this manually each time to have data imported into the Data Studio.

Note: To automate the above task or schedule to import the data in a timely manner, you may need to configure a trigger in Data Studio. For example, create a report daily for the previous day so you could run the script at Midnight every night. Please note, the script replaces any existing data, you may want to alter the script to create a different spreadsheet each time or append this spreadsheet.

Next, we’re going to create a trigger to automate the import process into the Google Sheet

Creating a Trigger (Optional)

If you don’t wish to create a trigger, you can skip to Connect to Data Studio

1. Hover over the « Clock icon » on the left. Click on « Triggers ».

2. Click on « Add Trigger ».

3. Choose the frequency to run the import.

4. Save the Trigger.

Connect the Google Sheet to Google Data Studio

1. Open Data Studio.

2. Click on « Create ».

3. Choose « Data source ».

4. Click on « Google Sheets », you may need to authorise Data Studio to access Google Sheets.

5. Select the Spreadsheet, which was created earlier (see section above) and leave the default options selected and Click on « Connect ».

6. For each field, check that the correct data type is selected or update it appropriately.

7. Click « Create Report ».

8. Click on « Add to report ».

9. You should now see the report with the data added.

Congratulations, you can now import and visualise your websites and visitors data within Google Data Studio.

What to do when you see curl: (60) SSL certificate problem: unable to get local issuer certificate error?

Error « curl: (60) SSL certificate problem: unable to get local issuer certificate » can be seen when the SSL certificate on the server is not verified or properly configured. In order to fix this please follow the steps below:

  1. Download the latest cacert.pem from https://curl.haxx.se/ca/cacert.pem

  2. Add the following line to php.ini: (if this is shared hosting and you don’t have access to php.ini then you could add this to .user.ini in public_html).


How to check the cohort report or performance of A/B test variations?

Ever wondered how to check the Cohort report or performance of A/B test variations. Well, it is possible in Matomo.

Creating a Segment based on the A/B test variation name and applying it to Cohort report will give you a clear picture of the performance of the variation matching the condition of Segment.

Note: you need to have Cohorts plugin along with A/B test plugin in order to achieve the above. To get accurate reports, the name of A/B test variation needs to be unique.

App analytics for Cordova / Ionic mobile apps

To track users and behavior analytics for your Cordova / Ionic mobile apps, you simply need to embed the Matomo Tracking code (JavaScript) into your app.

Additionally if your Cordova or Ionic app is a Single Page Application, read the SPA Tracking guide.

Cordova/Ionic apps don’t support cookies so you can learn how this will affect the accuracy of reports and tracking.

If you have any feedback or question about tracking your Cordova / Ionic app, please leave a comment in this issue.

App Analytics for Android apps (phones, tablets, Fire TV sticks) and iOS apps (iPhone, iPad, Apple tvOS and macOS)

To get valuable analytics measurement and reports, track your app users, screen views, events, and all your goals, in one place and access powerful analytics tool:

To learn more about what’s different when using Matomo for Mobile App Analytics Vs for website analytics: What features are supported when tracking Mobile App Analytics using Android or iOS SDK?.

If you use even other platforms or want to track server-side apps, there are more Tracking SDKs and integrations available for other platforms. Or if you have a website or intranet portal, you can also track them in Matomo and keep control of all your analytics data in one place.

Yes! Matomo is a cookie-less alternative for Google Analytics. This means you might not need to irritate your visitors with a consent screen and benefit from getting a more complete picture of how your visitors use your website.

With Matomo, you have several options to track visitors without using cookies:

How do I get RUM (Real User Monitoring) metrics and reports for my app, website and intranet?

Real User Monitoring (RUM) lets you collect useful metrics of users interactions with your website or app or Saas application. This will help you better understand how your users interact with your app, what works well and what is slow or which errors do people experience.

Matomo Analytics provides many tools for RUM analytics such as: