Welcome to Highlight
Getting Started
Overview
Backend / Server
Client / Frontend
Fullstack Frameworks
Tips
Content-Security-Policy
Local Development
Monkey Patches
Performance Impact
Proxying Highlight
Session Search Deep Linking
Troubleshooting
Upgrading Highlight
Session Replay
Console Messages
HTML iframe Recording
Identifying Users
Live Mode
Network DevTools
Privacy
Rage Clicks
Recording Network Requests and Responses
Session Sharing
Session Shortcut
Tracking Events
Versioning Sessions
Error Monitoring
Grouping Errors
Sourcemaps
Versioning Errors
Product Features
Alerts
Analytics
Canvas
Comments
Environments
Frontend Observability
Keyboard Shortcuts
Performance Data
Segments
Session Search
Team Management
User Feedback
Web Vitals
WebGL
Integrations
Amplitude Integration
Clearbit Integration
Electron Integration
Front Plugin
Intercom Integration
Linear Integration
Mixpanel Integration
React.js Integration
Segment Integration
Sentry Integration
Slack Integration
Vercel Integration
highlight.run Changelog
5.0.0
5.0.1
5.1.0
5.1.1
5.1.2
5.1.3
5.1.4
5.1.5
Menu
Docs / Session Replay / Identifying Users

Identifying Users

To tag sessions with user-specific identifiers (name, email, etc.), you can call the H.identify()method in your app. This will automatically index your sessions so that they can be filtered by these attributes.

H.identify( "eliza@corp.com", { id: "ajdf837dj", phone: "867-5309" } )
Copy
User Display Names

By default, Highlight will show the identifier as the user's display name on the session viewer and session feed. You can override this by setting the highlightDisplayName or email fields in the H.identify() metadata.

Customer User Avatars

You can replace the placeholder user avatars Highlight uses with an image that you provide. You can do this by setting the avatar field in the H.identify() metadata.

The image URL usually comes from your authentication provider (Firebase, Auth0, Active Directory, etc.). You can forward that URL to Highlight.

Saving the image

Highlight does not make a copy of the image. Highlight will render the image directly. This means the image will adhere to any authorization policies.

H.identify('steven@corp.com', { avatar: 'https://<IMAGE_URL>.png' })
Copy
API

See the H.identify() API documentation for more information on how to use it.

What happens before a user is identified?

All key session information is tracked regardless of whether a session is identified. Highlight will generate an identifier for a user which you can see in the session player unless you set your own by calling H.identify().

When a user is identified we will attempt to assign their information to previous sessions from the same browser. If this happens you will see an indicator in the UI showing the data was inferred for a session and that the session was never explicitly identified.