Watch for Event sets a desktop notification trigger on any event name. v2.0 introduces multi-watch with per-site scoping and cross-tab notification firing.
Setting a watch
- Click the bell icon in the Live Events tab header.
- Enter an event name (e.g.
purchase) or a regex literal (e.g./^add_to/). - Choose scope: This site only (default) or All sites.
- Click Save. The chip appears in the Live Events action bar.
Per-site vs global
Per-site watches attach to the current host. They fire only on that host. Useful when you're QA'ing one specific site.
Global watches fire on every site you visit. Useful for an event name that's universal in your stack — you want to know any time it fires, anywhere.
Cross-tab notifications
v2.0 notifies regardless of which tab the panel is focused on. If you're working in tab A and a watched event fires in tab B (panel not active there), you still get the desktop notification.
Watch chips
Active watches appear as chips in the Live Events action bar. Per-site chips have a globe-with-strike icon; global chips have a plain globe. Click a chip to see its definition; right-click to delete.
The notification
Clicking a notification:
- Brings the matching tab to the foreground
- Opens the Pixel Auditor panel if not already open
- Switches to Live Events filtered to the matching event
Watched event styling
When a watched event matches, its row in Live Events gets a violet eye badge with a one-shot pulse animation. The severity left-bar turns violet. Easy to spot in a busy stream.
Migration from 1.0
If you upgraded from 1.0, your old watched event(s) migrate automatically:
tpc_watched_event(single string, 1.0) →{ global, byDomain }tpc_watched_events(flat array, mid-1.x) →{ global, byDomain }
Existing watches become global. No action needed.
Removing a watch
- Right-click the chip → Remove
- Or open the bell modal → click the × next to the watch entry