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 4, 2026