Create events

• Visual picker: Launch from Events → Select Element Visually. Hover highlights matches, and you can cancel with ESC or minimize to navigate.
• AI suggestions: Open the hint, describe what you want (“Track the Pricing CTA”), and click Suggest — selectors and names are proposed for you.
• Editable selectors: Fine‑tune the CSS selector directly in the config dialog.
• Quick save: Save All confirms, shows a short loading state, and refreshes the Events list automatically.
• Event types: Click, Page Visit (by URL/URI), Form Abandoned, and Manual (from your app code).
• GA4 forwarding: Enable “Forward to GA4” on the event to send a client‑side GA hit when available.

How it works

• Instant updates: As soon as you save, definitions are sent to the recorder — no redeploy needed.
• Single‑page apps friendly: Page visits and form states work across route changes.
• Accurate counts: Each occurrence is recorded individually, so trends, cohorts, and breakdowns stay reliable.

Manual custom events (from code)

Besides auto‑tracked event types, you can trigger a custom event directly from your app code. Use the ready‑guarded pattern below so it works reliably on every page load.

// Wait until the recorder is ready
window.addEventListener('revisit:ready', (e) => {
  const recorder = (e.detail && e.detail.recorder) || window.revisit
  if (!recorder || typeof recorder.trackCustomEvent !== 'function') return

  // Trigger your custom event with optional metadata
  recorder.trackCustomEvent('eventName', { source: 'your-app' })
})

// Tip: to see this in Custom Event analytics, create an event named "eventName"
// in Events and keep it Active. Otherwise it's recorded as an unnamed custom event
// visible in the session timeline but not counted in analytics.

• Analytics visibility: The name must match an active Custom Event to appear in analytics. Otherwise it’s recorded as an unnamed custom event.

Analytics

• Breakdown: Slice by Country, City, Device, Browser, OS, and URL. Hover to compare, and click View sessions to jump into affected sessions.
• Conversion rate: See what share of sessions and visitors triggered the event.
• Cohort analysis: Measure how well cohorts keep triggering the event over time (daily/weekly/monthly).
• Time to event: Understand how quickly users reach the event from session start.
• Period comparison: Compare with last week/month/year and spot trends instantly with % deltas.

Session view

• Custom events appear in the Events tab with their name and a quick link to analytics.
• Timeline markers for custom events use a distinct color; toggles let you show/hide types.
• Filter Events tab by type: Navigate, Click, Input, Error, Analytics, Custom.

Use cases & tips

• Track key CTAs: Pricing “Start trial”, Add‑to‑Cart, Onboarding “Continue”.
• Spot friction: Form Abandoned on checkout or sign‑up.
• Measure help usage: “Help Center opened” or “Search performed”.