There are two ways you can double-check that your event definitions are working: check the analysis preview and check the live data feed.
Check Analysis Preview
On the Event details page (Define > Events > click the event you’d like to see the details for), you’ll notice an Analysis Preview section. This preview gives you an at-a-glance view of your event grouped by various properties, depending on the type of event.
For this pageview event, which is defined as any page matching /examples/*
, we can see the top 5 matching paths, verifying that our event is correct. Other events have different groupings, like href
, target text
, or custom properties for custom events.
CSS character limit
Heap has a 1024 character limit for parent hierarchy capture and truncation.
If there are too many characters in the hierarchy between the child selector and the parent selector, your definition won’t work.

Check the Live data feed
Heap’s Live data feed provides you with a streaming feed of all of your Heap events. You can use this page to QA your event definition by checking that when you take an action corresponding to your event definition, that event is captured in Heap.
To learn how to QA event definitions in the live data feed, see Live Data Feed.