Prevent duplicate crash entries caused by versioning URL parameters

Cloud On-Premise

In Crash Analytics, you can define Versioning URL Parameters that tell Matomo which URL parameters to ignore when identifying crashes.

Some websites append parameters to JavaScript file URLs for cache control or versioning purposes. These parameters do not change the underlying source file, but they can cause the same crash to appear as separate entries in Crash Analytics reports, for example:

app.js?v=123
bundle.js?cb=456

By ignoring versioning or cache-busting parameters, Matomo groups crashes from the same source file together. This can reduce duplicate crash entries, improve report readability, and make recurring crashes easier to identify.

Define URL parameters

  1. In Matomo, go to Administration admin gear icon > System > General settings > Crash Analytics.
  2. Use the Versioning URL Parameters setting to define additional query parameters to be excluded when matching crash source files.
  3. Default parameters included in the list: v, ver, version, cachebuster, cb, timestamp, ts, rnd, random, rev, revision, build, b, id, ref.
    versioning url parameters in crash analytics

You can also enable the Group Source Files with Hashes option in Crash Analytics settings, which groups JavaScript files that use hashed filenames generated during application builds or deployments.

Read more about Crash Analytics in Matomo Cloud or On-Premise FAQs.

Previous FAQ: How to track JavaScript errors that occur before Matomo JS tracking code is loaded