> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Track User Properties

> Set user attributes and properties for enhanced user profiling.

<Warning>
  **Important:** Please ensure your CMP configuration includes new **Vendor ID 1469** for 1st Party data tracking. Additionally, include **Vendor ID 301** if cookie sync is enabled. [Learn more](/articles/sdks/web-js/configurations/consent-options#shouldcheckzeotapvendorconsent)
</Warning>

The `setUserProperties` method sends user properties along with default user properties. Use this to attach user information for known users.

**Key Characteristics:**

* **Sent as Event:** Calling `setUserProperties` triggers an event with the event name `set_user_properties`.
* **Non-Persistent:** The properties sent via this method are associated with this specific `set_user_properties` event. They are **not** automatically persisted in the storage or automatically included with subsequent, different events (like page views or custom events triggered by `setEventProperties`).
* **Distinct from [`setUserIdentities`](/articles/sdks/react-native/api-reference/set-user-identities):** This function is different from `setUserIdentities`, which is used for establishing and persisting core user identifiers. `setUserProperties` is for sending additional, often more dynamic or contextual, user-level attributes.

## Syntax

```javascript theme={null}
setUserProperties(userProperties, callback)
```

## Parameters

| Parameter      | Type     | Required | Description                          |
| -------------- | -------- | -------- | ------------------------------------ |
| userProperties | Object   | Yes      | Key-value pairs of user properties   |
| callback       | Function | No       | Callback function to handle response |

## Usage Examples

### Basic User Properties

```javascript theme={null}
import { setUserProperties } from 'zeo-collect';

setUserProperties({
    age: 28,
    gender: "female",
    subscription_tier: "premium",
    location: "New York"
});
```

The detailed user properties will be passed in the payload:

```json title="Detailed page properties in payload" {7-13} theme={null}
    "events": [
        {
        "event": {
            "eventName": "set_user_properties",
            "eventTimestamp": 1745959356443
        },
        "user": {
            "zi": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
            "age": 28,
            "gender": "female",
            "subscription_tier": "premium",
            "location": "New York"
        },
        "page": { /* ... */ },
        "version": "1.3.8"
        }
    ]
```

### With Callback

```javascript theme={null}
setUserProperties({
    user_tier: "gold",
    preferences: "notifications_enabled",
    theme: "dark"
}, (response) => {
    console.log("User properties set:", response);
});
```

## Related Methods

* [setUserIdentities](/articles/sdks/react-native/api-reference/set-user-identities) - Set user identities
* [setEventProperties](/articles/sdks/react-native/api-reference/set-event-properties) - Track events