Please note that below guide is only about disabling or enabling media events (MediaVideo play, seek, pause, resume). All other media data for the media analytics reports are always tracked by default.

These media events also appear in the visits log:

Matomo Cloud

On the Matomo Cloud media player interactions like play, seek, pause and resume are not tracked as events by default as each event counts towards your hit’s quota.

You can enable the tracking of media events like play or pause by adding the below JavaScript tracking code to your website:

window._paq = window._paq || [];
window._paq.push(['MediaAnalytics.enableTrackEvents']);

You can also email the Matomo Cloud support to enable the tracking of these events by default and then you won’t need to make any changes to your tracking code.

If you have been on the Cloud since 2021 or before, then media events may be tracked by default. In this case you can disable the tracking of media events by adding the below JavaScript tracking code to your website:

window._paq = window._paq || [];
window._paq.push(['MediaAnalytics.disableTrackEvents']);

Matomo On-Premise and Matomo for WordPress

Media player interactions are automatically being tracked as events like play, seek, pause and resume.

To disable the tracking of these events for a particular site, add the below JavaScript code to your website:

window._paq = window._paq || [];
window._paq.push(['MediaAnalytics.disableTrackEvents']);

To disable the tracking of events by default for all of your sites, set below setting in your Matomo config/config.ini.php.

[MediaAnalytics]
enable_event_tracking_by_default = 0

More information

Click here for more detailed developer documentation about Media Analytics.

Previous FAQ: How do I customize the tracking of my media?