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

# User Properties

> List of user properties that can be synced to your 3rd party platform integrations.

## Static Properties

These properties are predefined by GuideWhale and should be provided when identifying or importing users into GuideWhale.

<ParamField path="user_id" type="string" required>
  Primary user identifier used to identify users across integrated platforms. Usually a unique ID or an email address.
</ParamField>

<ParamField path="email" type="string">
  User's email address.
</ParamField>

<ParamField path="image_url" type="string">
  URL of user's profile image.
</ParamField>

<ParamField path="first_name" type="string">
  User's first name.
</ParamField>

<ParamField path="last_name" type="string">
  User's last name.
</ParamField>

<ParamField path="date_signed_up" type="date">
  Timestamp when user signed up for your application.
</ParamField>

## Automatically Populated Properties

Any property starting with and underscore(\_) is reserved for internal use and is automatically populated by GuideWhale.

<ParamField path="_date_first_seen" type="date">
  Timestamp when user was first seen by GuideWhale.
</ParamField>

<ParamField path="_date_last_seen" type="date">
  Timestamp when user was last seen by GuideWhale.
</ParamField>

<ParamField path="_last_nps_score" type="number">
  How satisfied user is with your application (0-10).
</ParamField>

<ParamField path="_last_device" type="string">
  Last device type that user logged-in with (desktop, tablet, mobile).
</ParamField>

<ParamField path="_last_os" type="string">
  Last operating system that user logged-in with.
</ParamField>

<ParamField path="_last_browser" type="string">
  Last browser that user logged-in with.
</ParamField>

<ParamField path="_last_locale" type="string">
  Last detected user browser language.
</ParamField>

<ParamField path="_session_count" type="number">
  How many different application sessions user has started.
</ParamField>

<ParamField path="_experiment_group" type="number">
  Randomly assigned group (useful for A/B testing).
</ParamField>

<ParamField path="_is_anonymous" type="boolean">
  Whether user has a known ID or is anonymous.
</ParamField>

## Custom Properties

You are able to add custom user properties through the GuideWhale dashboard. These can then be used across the platform to segment users or target and personalize in-app content.
