UserSignal  / Users & Segments

Custom Properties

Learn how to pass custom properties to UserSignal for user segmentation.

Pass any data you want about your users using data-user-* attributes on the widget script tag.

Examples

data-user-plan="pro"
data-user-company="Acme Inc"
data-user-role="admin"
data-user-signup-date="2026-01-15"

Where they appear

  • User profile pages in the dashboard
  • Chat sidebar when viewing conversations
  • Segment targeting rules for announcements

Properties are updated every time the widget loads, so they always reflect the latest values from your app.

Updated September 3, 2026