Help Center › Getting Started

Identifying Users

Last updated: March 2026

UserSignal tracks users by the data-user-id you pass in the script tag. This should be a stable, unique identifier — like a database ID or UUID.

Why identify users?

  • See who submitted feature requests and votes
  • View user profiles with browser, OS, and custom properties
  • Target announcements to specific user segments
  • Have chat conversations tied to real user accounts

Custom properties

Pass additional data about your users with data-user-* attributes:

HTML
<script src="https://app.usersignal.co/widget.js"
  data-key="YOUR_API_KEY"
  data-user-id="12345"
  data-user-name="Jane Smith"
  data-user-email="jane@example.com"
  data-user-plan="pro"
  data-user-company="Acme Inc">
</script>

Custom properties appear in user profiles and can be used for segment targeting.