Getting started

Crash Analytics must be enabled before Matomo can collect and display crash reports. The steps depend on whether you use Matomo Cloud or On-Premise.

Before you start, ensure your websites already include the JavaScript tracking code or the Tag Manager container code.

Matomo On-Premise

1. Install and activate the Crash Analytics plugin from the Matomo Marketplace.
2. To configure the settings, log in to Matomo and open Administration > System > General settings > Crash Analytics.
3. Once the plugin is enabled, Matomo automatically starts tracking crashes.

Matomo Cloud

Crash Analytics is available in Matomo Cloud and does not require a separate plugin installation.

1. To enable Crash Analytics, log in to Matomo and open open Administration > System > General settings.
2. Go to the Crash Analytics settings and make sure the Disable Crash Analytics option is not selected.
3. To configure the other settings, refer to the guide Crash Analytics for Matomo Cloud.
4. Once enabled, Matomo automatically starts tracking crashes.

Test Crash Analytics is working

1. For testing purposes, temporarily add a JavaScript to a web page, see how to generate a test error.
2. Open the page in your browser to trigger the test error.
3. Confirm that the error appears in Matomo in the Visits Log or under Crashes > Overview.
   

Once Crash Analytics is enabled, you can analyse crash reports to investigate JavaScript errors occurring on your website.