Matomo for WordPress is available in the WordPress plugins directory. Before you install the plugin in your WordPress, first check the requirements. 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.

1. Through the WordPress plugins directory (recommended)

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

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

Should you not be able to install the plugin this way, please visit our plugin on the WordPress directory and download the latest zip file from there. 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.

3. By downloading the plugin and uploading the zip file

  • Download the zip file from ttps://wordpress.org/plugins/matomo/
  • Log in to your WordPress Admin Dashboard
  • Go to Plugins => Add new
  • Click on “Choose file” button
  • Select the previously downloaded zip file
  • Click on “Install Now”

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.