What are the requirements for Matomo for WordPress?

Cloud On-Premise

Your environment must meet the minimum requirements for Matomo for WordPress. Review the upcoming changes and current requirements before installing or updating the plugin.

Requirements for WordPress

These requirements apply to all supported versions of Matomo for WordPress. Make sure your WordPress installation has sufficient memory and meets the minimum WordPress version before installing or updating the plugin.

  • WordPress 4.8 or later
  • We recommend having at least 128MB of memory configured. High-traffic websites may require more memory.

Requirements for Matomo

Matomo 6

By November 2026, your server environment must meet the minimum requirements to continue receiving the latest Matomo for WordPress features, fixes and security updates.

  • PHP 8.1 or later
  • MySQL 8.0 or later, or MariaDB 10.6 or later

The Matomo for WordPress plugin cannot be updated to Matomo 6 until your server meets these requirements. Contact your hosting provider if you cannot manage the server directly.

Matomo 5 and earlier

Minimum requirements for Matomo 5 and earlier versions:

  • PHP 7.2 or later
  • MySQL 5.5 or later, or MariaDB

Configuration and compatibility notes

  • If you have WP_DEBUG enabled, then some notices re MySQL might appear which can be ignored.
  • If you have configured a custom content directory using WP_CONTENT_DIR or are using symlinks, then parts of the plugin might not work. You may be able to workaround this.
  • There may be an issue if you are using an incompatible plugin

A note on performance
Running an analytics tool within your WordPress basically causes your server to receive an extra request for each page view. If your server is already on it’s limit in terms of CPU/LOAD, then you may want to consider installing Matomo on a separate server using Matomo On-Premise, or sign up for a Matomo Cloud account where we do the hosting for you, or ask your hoster to upgrade your server.

A note on WP Multisite
Matomo for WordPress supports WP Multisite. However, there are some restrictions like you won’t be able to aggregate analytics data across blogs and if you are managing many blogs, Matomo On-Premise or Matomo Cloud might be better suited for you. Learn more about how it compares to Matomo On-Premise.

How to install Matomo
Do you meet these requirements? Or want to simply give it a try? Click here to read the instructions on [how to install the Matomo for WordPress plugin in your WordPress].(https://matomo.org/faq/wordpress/how-do-i-install-matomo-for-wordpress/)

If you already have a running Matomo On-Premise or Matomo Cloud
Then you will want to install the Connect Matomo Integration plugin and not our Matomo for WordPress plugin. Learn more about the differences between Matomo Analytics and Connect Matomo Integration.