How do I install Matomo for WordPress?

Matomo for WordPress is the easiest way to host Matomo on your own servers which takes less than a minute to install and requires no technical knowledge.

Introducing Matomo for WordPress

Note: If you already have a running Matomo On-Premise or a Matomo Cloud account, then you will want to install the WP-Matomo Integration plugin and not our Matomo for WordPress plugin. Below you find three ways on how to install Matomo for WordPress.

Option 1. Install through the WordPress plugins directory (recommended)

Requirements

  • PHP 7.2 or greater
  • MySQL 5.5 or greater is recommended
  • 128MB memory or greater is recommended
  • WordPress 4.8 or greater
  • If you are unaware of your server’s capacity, we recommended only using for websites up to 50K page views/month
  • If your not sure of your servers capacity you can also host Matomo through our Cloud service or host Matomo On-Premise

Installation

  • Log in to your WordPress Admin Dashboard
  • Go to Plugins => Add new
  • Search for “Matomo Analytics Ethical Stats”
  • Click on Install
  • Click on Activate

Option 2. By downloading the plugin and uploading the files to your server

Should you not be able to install the plugin this way, please download the latest ZIP file for our plugin from the WordPress directory. Now unzip the content and upload it on to your server using ftp, ssh, or similar. Make sure the plugin is placed in the wp-content/plugins/matomo directory. Learn more

Option 3. By downloading the plugin and uploading the zip file

Your upload might result in some error. This is often because servers have some default limits configured of how much data can be uploaded by default and how long it can take to upload it max. These limits can be exceeded when uploading the plugin. The easy way to workaround this is to try another way of installing it (see previous options). The more complicated and technical way is to change your PHP configuration where you would need to tweak PHP settings like these

upload_max_filesize = 20M
max_input_time = 600
max_execution_time = 600

How these settings can be changed depends on your hoster / server. The shown values are only suggestions and if the already configured value is higher, than you don’t want to change that value.