How do I install the Matomo tracking code on WordPress?

It’s easy to add Matomo tracking to your WordPress site. You can either use the easy WordPress plugin (using the steps below), install the JavaScript code (using this guide), or install an image beacon (using this guide).

Requirements

• A Matomo account: Cloud or On-Premise (self-hosted).
• Administrator account in WordPress
• WordPress.com site with a Business, Commerce or Enterprise plan, or a Self-hosted WordPress site.

Steps to start tracking in Matomo

1. Install the “Connect Matomo (WP-Matomo)” plugin in your WordPress.

   • Log in to your WordPress site as the administrator.
   • In the left menu, Click on “Plugins” > “Add new” (if you can’t see the “Plugins” menu, then you can instead follow these steps to insert the Matomo tracking code manually in your WordPress Theme files).
   • Search for “Connect Matomo” in the Keyword field in the “Add Plugins” page.
     
   • click on “Install Now” next to the “Connect Matomo” plugin
     
   • Now that the plugin is successfully installed, click on “Activate”.
     

2. In the left menu, click “Settings” > “WP-Matomo”.
   

3. In the “Matomo Mode” dropdown, select the option “Self hosted (HTTP API, default)”.
   

4. In the “Matomo URL” text field, enter your Matomo URL, for example https://analytics.example.com.

5. In the “Auth token” text field, enter your Matomo authentication token. How to find Auth Token.

6. Confirm the “Auto config” checkbox is selected and click on “Save Changes”.

7. You should see “Connect Matomo is successfully connected to Matomo” message. If you do not see the message, make sure the values you provided in the previous steps are correct, and try again.

8. Click on the “Enable Tracking” tab.

9. In the “Add tracking code” dropdown, select “Default tracking”.
   

10. Click on “Save Changes” and a success message will appear.
    

Congratulations, you should now be successfully tracking visitors with Matomo Analytics through your WordPress site! Happy Analytics.