Matomo suddenly has a 'subfolder' so can't use/connect issue

We just updated MainWP, etc on the dashboard site, and we suddenly get an error regarding Matomo, which had been working perfectly before. Please advise how to fix/get this connected again:

The Matomo URL includes a subfolder, which is not supported. Matomo must be reachable at the root of an https:// address, such as https://matomo.example.com/. Put Matomo on its own subdomain, then enter that address in the Matomo URL field and click Save Settings.

Hey @SuppY

Yes, this requirement was introduced in the Matomo 5.2 update. The add-on changed how connections and API tokens are handled and now requires Matomo to be available at the root of an HTTPS address, such as https://matomo.example.com/ .

Earlier versions accepted subfolder addresses, so your existing connection can stop working after this update even though nothing changed in your Matomo setup. Sorry for the disruption this causes.

To reconnect with the current version, Matomo needs to be accessible at an HTTPS address without a subfolder.
Then update Matomo URL under MainWP > Add-ons > Matomo > Settings (/wp-admin/admin.php?page=Extensions-Mainwp-Piwik-Extension&tab=settings ) and click Save Settings .

Simply removing the subfolder from the saved URL will only work if Matomo is actually accessible at that root address.

May I ask Why? (why does a working MainWP plugin have such a service-disrupting change)

Sorry for the inconvenience, @SuppY.

I’ve logged this for development review to see whether subfolder support can be restored while keeping the Abilities API integration and security improvements.

Hey @SuppY

We’ve released Matomo Add-on 5.2.1, restoring subfolder support while keeping the security improvements from 5.2.

Please update and let us know if your connection is working again. Thanks for your patience!

Just updated .. and no. It didn’t solve it ..

Screenshot_ 2026-10-17 at 14.56.17

Could you open MainWP > Add-ons > Matomo > Settings , check that the URL starts with https:// and includes your Matomo subfolder, then click Save Settings ?

If the server and folder haven’t changed, leave the API token blank.

If it still fails, please open a private Help Desk ticket so we can take a closer look.

Please refer to this Community thread by its URL in the ticket.

ticket opened as it still doesn’t do it :slight_smile: