Identify signed-in users

Track signed-in users across sessions, replays, funnels, and errors. Once identified, all subsequent events from the browser are linked to that user, and the user shows up on the Users page.

Identify the current user

Call betterstack('user', ...) after sign-in:

betterstack('user', {
  id: 'user_123',
  email: 'user@example.com',
  username: 'John Doe',
  plan: 'premium',
});

id, email, and username uniquely identify the user. Users are keyed by the first available value of id, email, and username.

You can add arbitrary custom properties, like plan in the example above. They're stored alongside the user data.

The association persists for the page session. To clear it at sign-out:

betterstack('user', null);

What identification unlocks

• Users page: Identified users appear on Users with their sessions, errors, location, and attribution data. See Analyzing users.
• Sessions: Filter Sessions with the Signed in users preset, or search by user.id or user.username.
• Session replays: Replays are linked to the identified user, so you can watch exactly what a specific user experienced.
• Auto-capture: With Auto-capture identified user events enabled in the Frontend tab, clicks, form submissions, and other interactions are captured automatically for identified users.

Next steps

• Identify groups: track behavior of entire teams or organizations.
• Analyzing users: work with the Users page.