When you upgrade Matomo (Piwik) to the latest version, it sometimes happen that Matomo stops working — especially when the User Interface is not working (blank white page, widgets not loading, error message, etc.).

There are a few things to check that will most likely resolve the User Interface issue you are having:

  • 1) Delete your browser cache or try to access your Matomo with a different browser. If it still does not work…
  • 2) Delete all files in piwik/tmp/*. After deleting the files and directories, refresh the page. If it still does not work…
  • 3) Activate the display of PHP errors in your web server configuration. This may turn your white page into a useful error message page.
  • 4) Check your web server error logs. Maybe your error log will contain an explanation for the problem. If the log file has no Matomo related error…
  • 5) Reupload all Matomo files from the latest version. Sometimes, there are errors while uploading files and some of your Matomo files were maybe not overwritten by the latest version. Upload all files again, and check in your FTP software that the upload was successful.

Also, check out the other FAQs in this “Troubleshooting” category, as there might be other solutions for your problem.

If it still does not work, please search the Matomo Forums or search this website, and if there is no post about your problem, please create a new topic.