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.

Verify Crash Analytics is working

After enabling Crash Analytics, you can add an intentional error on your website page to test crash tracking.

1. Add a test error to a web page, for example: throw new Error("Crash Analytics test error");
2. Open the page in your browser to trigger a test JavaScript 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.