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