We are proud to announce Matomo 3.12.0: a new release of Matomo Analytics.

What’s new?

Matomo 3.12.0 comes with a very exciting new feature, several significant performance improvements, usability improvements and fixes to security issues.

We’re excited to deliver one of the most exciting new features in years.

Introducing the Data and Segment Comparison feature!

You can now compare multiple dates within the calendar selector in Matomo:

And you can compare segments together with a click within the Segment editor:

Try out these features today in your Matomo to see the power behind this new data comparison mode.

With this release, we have also significantly changed the way the data archiving process works and in particular we have rewritten SQL queries in a way that makes archiving significantly faster across the board. This is a major performance improvement and if you run a high traffic Matomo site or if you are using many segments, you should notice a significant reduction in CPU and IO usage during the core:archive archiving cron task. And this change has also fixed a persistent issue which was reported dozens of times over the years in multiple tickets. We’re very happy that this is now fixed.

With each new release, Matomo becomes faster and more reliable. We’ve made a dozen smaller performance improvements such as making Real-time queries faster for high traffic sites, made improvements to the DB Writer/Reader feature, introduced a new `core:archive` parameter to disable processing of reports for segments for “Today” ` –skip-segments-today` which is very useful when you have a lot of segments. You can now specific a INI setting (`live_query_max_execution_time`) to let any Real-time SQL query time out after a few minutes and prevent them from running for hours possibly doing nothing (we found this setting very valuable to prevent edge cases of slow running/never finishing SQL queries for high-traffic Matomo servers). We also released a new plugin DeviceDetectorCache which makes Tracking API requests faster and use less CPU.

In terms of usability improvements. It is now easier to validate your segments when you create and edit them: you can now click a “Test” button which will show the list of all visits matching the segment in a popover. Also, in all table reports, the first column will now stick to the left, making it easier to view your data when the table is wide and you’re scrolling right to view more columns. You can also now easily search Matomo user guides and FAQs directly from the Matomo Help screen. And to make it easier to setup tracking in Matomo, you can now easily send an email to developers with instructions on how to install the Matomo JavaScript Tracking code. And we’re now showing the Matomo logo in the top-left of the app!

When you embed Matomo reports as iframe, you can now prevent scrollbars from showing up (the height of the iframe will be automatically adjusted to the height of the content height of the iframe)

Dozens of smaller bugs and issues were fixed. Matomo 3.12.0 should also be compatible with PHP 7.4 (let us know if you notice any issue).

We are grateful for all community members who reported feedback and suggestions, our awesome team of translators for their work, and our Matomo Cloud hosting customers and Premium features customers for their amazing support.

242 tickets have been closed by more than 23 contributors!

After You Update

  • Please help us spread the word! Maybe you can write about the project on your blog, website, twitter, talk at conferences or let your friends and colleagues know what is Matomo. Already 1,000,000+ websites are keeping full control of their web analytics with Matomo!
  • Use the forums if you have any question or feedback (free support),
    or purchase a Support Plan to make the most of your Matomo Analytics and get professional support.
  • To improve Matomo in your language consider contributing to translations.
  • You can also support our efforts by purchasing valuable Premium Features for Matomo or try our Matomo Cloud solution.

Security release

This release is rated major. Two Denial Of Service (DOS) issues have been fixed, both reported via our HackerOne Matomo program.

Our security bug bounty program welcomes & rewards researchers who discover and responsibly report to us any security issues found in Matomo or any of the plugins created by Matomo/InnoCraft.

Database upgrade

This release does not contain any major database upgrade.

Platform Changes

Matomo is an open analytics platform. In an effort to help Matomo developers learn about improvements and changes in the core APIs, we document the changes since the last release.

In this 3.12.0 release there are new Events available for plugins. Read more in Platform Changelog for Developers to see all changes to the platform and APIs.

Note: the Marketplace showcases more than 100 plugins already compatible with Matomo 3 and this is just the beginning. Matomo is your universal data analytics platform!

New and updated SDKs (Tracking API Clients)

The Matomo team offers official SDKs (Tracking API Clients) for measuring your mobile apps and any other kind of apps.

New and updated guides and FAQs



New plugins

By the Matomo team and InnoCraft:

By third party developers:

Need help upgrading Matomo?

Read the Updating Matomo user guide or for more help contact the Matomo experts.

List of 242 tickets closed in Matomo 3.12.0

We are together creating the best open analytics platform in the world. You can help make Matomo even more awesome by getting involved in Matomo!