Custom event tag

Tag Manager

The Custom event tag lets you track an event on your website. For example, you can track a button click, page-scroll depth, newsletter signup, or another event. 

Each custom event consists of four elements: event category, action, and optionally name and value. After setting up the tag, these elements appear in the custom event report.

To create and set up the custom event tag, follow these steps:

  1. Go to Menu > Tag Manager.
  2. Navigate to Tags.
  3. Click Add a 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 in Piwik PRO

    Note: You can track a previously created custom dimension along with the event by picking the index number of the dimension and providing its value. For more, read this article.

  7. In Advanced tag settings, choose Consent type. Set it up if you use a consent form on your site. This tag will fire only for visitors who accept the selected consent type.
  8. Respect opt-out and DNT is turned on by default. Leave it as is, if you want to respect visitors who set Do-Not-Track in their browsers, or visitors who opt out of tracking using our opt-out form.
  9. Enable document.write is turned off by default. Toggle this option, if your tag needs document.write.
  10. In Flight dates, set the date and time when the tag is fired.
  11. In Tag triggers, click Add a trigger or Choose existing trigger to set up a trigger for your tag.
  12. Adjust trigger conditions.
  13. When you’re done, click OK for the trigger.
  14. Click Save for the tag.
  15. Test your tag in debug mode.
  16. When you’re happy how the tag works, click Publish.
  17. After some time, data will be collected and you will be able to see the event under Menu > Analytics > Reports > Custom events.
    Custom event report in Piwik PRO

Was this article helpful?

Technical support

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

Back to help center