How do I add the metric “Events” to a Custom report?

Unfortunately, creating a custom report specifically with the “Events” metric is not currently possible in Matomo. The best alternative available is using the “Hits” metric which counts all actions, including events.

What does the “Hits” metric count in a custom report?

The “Hits” metric in a custom report counts all actions, regardless of their type. If no filter is applied to the custom report, “Hits” will count all actions.

How does the “Hits” metric behave when a filter is applied in a custom report?

When a filter is applied in a custom report and it specifically filters for events, “Hits” will count only the event actions that match the filter. If the filter excludes other types of actions, “Hits” will reflect the count of event actions based on the applied filter. In this case, “Hits” is a close approximation to the “Events” metric.