You can attach custom visitor information (like user ID, email, subscription plan, etc.) to the current session so it appears in the Revisit dashboard and is available for search and filtering.

Quick Example

Listen for the revisit:ready event, then call setVisitorData. Optionally set a profile picture URL.

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

  // Attach simple placeholder traits
  recorder.setVisitorData({
    userId: '123',
    email: 'jane@example.com',
    plan: 'pro'
  })

  // Optional: show an avatar in the session details
  recorder.setProfilePictureUrl('https://i.pravatar.cc/256?img=1')
})

What Can I Send?

• Common fields:userId, email, name, plan, teamId
• Any JSON-serializable object works: recorder.setVisitorData({ featureFlag: 'A' })

When Should I Call It?

• Right after login or whenever user identity becomes available
• Whenever user traits change (e.g., plan upgrade) — call again to update

Important Notes

• If a browser privacy signal like Do Not Track or Global Privacy Control is enabled, recording (and identifiers) may be disabled
• Make sure the recorder script is installed on the page and initialized before listening to revisit:ready
• Data is sent in real-time via WebSocket to the Revisit API