You’ll need at least the following to run Matomo for WordPress

  • WordPress 4.8+
  • PHP 7.2+
  • MySQL version 5.5 or greater, or MariaDB
  • We recommend having at least 128MB memory configured. If you have a high traffic website you may require more memory.

  • 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.

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.