Skip to main content

Node — Set person properties

Set or update user properties from the server with setPersonProperties (overwrites) or setPersonPropertiesOnce (only if not already set). Pass sessionId and windowId when correlating with the client session.

setPersonProperties(distinctId, properties, sessionId?, windowId?)

Sets user properties (overwrites). Sends $set event. When to use: Update user properties without sending an $identify event (e.g. when properties change after initial identification).

setPersonPropertiesOnce(distinctId, properties, sessionId?, windowId?)

Sets user properties only if not already set. Sends $set_once event. When to use: One-time attributes that shouldn’t be overwritten (e.g. signupSource, firstPurchaseDate).

See also