Create a custom event

Analytics + Tag Manager

Needed permissions: owner, manage, edit&publish

When you want to collect additional data about events that happen on your site or app, you need to create a custom event using a ready-made tag in Tag Manager. This tag will pass information about an event category, name, action and value to Analytics, and you’ll see it in a custom event report.

Custom event in Piwik PRO

To create a custom event, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Navigate to Tags.
  3. Click Add new tag.
  4. Name the tag and select the following type: Custom event.
  5. Click Next.
  6. Add CategoryAction, and optionally Name and Value that you want see in reports for this event.
    Custom event setup
  7. In Advanced tag settings, choose Consent type. Set it up if you use Consent Manager. The tag will fire only when selected consent is given by a visitor.
  8. In Tag triggers, click Add new trigger or Choose existing trigger to set up a trigger for your tag.
  9. Adjust trigger conditions.
  10. When you’re done, click OK for the trigger.
  11. Click Save for the tag.
  12. Test your tag in debug mode.
  13. When you’re happy how the tag works, click Publish.
  14. Now your data is collected and you can see it the event under Menu > Analytics Reports > Custom events.
  15. You can also see custom events under Analytics > Reports > Session log.
    Custom event in the session log report in Piwik PRO.

For developers: You can set up custom events manually by modifying the tracking code.

Was this article helpful?

Technical support

If you still have some questions, visit our community.
There’s always someone ready to help!

Related articles

Back to help center