Custom event tag

Tag Manager

Video tutorial: watch on YouTube

A custom event tag allows you to track events like button clicks, newsletter subscriptions and other custom events on your site. Each custom event is labeled with an event category and action. It may also contain the name and value of the event.

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 your tag and select the following type: Custom event.
  5. Click Next.
  6. Add the following elements:
    • Category (string, required): The category of the event you’re tracking. The category organizes events into groups. Example: Buttons.
    • Action (string, required): The action of the event you’re tracking. The action tells you what a visitor did. Example: Click.
    • Name (string, optional): The name of the event you’re tracking. The name gives you more information about the event. Example: Sign up (a CTA on your button).
    • Value (float, optional): The value you want to assign to the event you’re tracking. Example: 5. If an action is worth some money for your business, like a signup button click is worth 5 USD, you can assign a value for it. Every time an event happens, Piwik PRO will count the value and show the total value in an event report.
    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 only fire 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’ve turned on the Do-Not-Track feature in their browsers or who’ve opted out of tracking using our opt-out form.
  9. In Flight dates, set the date and time when the tag will fire.
  10. In Tag triggers, click Add a trigger or Choose existing trigger to set up a trigger for your tag.
  11. Click Save.
  12. Test your tag in debug mode.
  13. When you’re happy with how the tag works, click Publish.
  14. All set! After a while, data will be collected and you’ll see it in Menu > Analytics > Reports > Custom events.
    Custom event report in Piwik PRO

Was this article helpful?

Technical support

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

Back to help center