Skip to main content

User properties

User properties overview

Properties are individual fields to be captured for a customer. For example, name, phone number, gender, email address and more. There are several predefined fields that you can use to capture a user's data. You can also create custom properties if required.

A customer is identified with a unique identifier userId. This can be any unique identifier such as mobile number, email adress, or any other identifier. However, you can set only one property for the userId for your org.


This is enabled only for

There are two types of user data that is supported in User 360:

  1. User properties

    i. System user properties: Default data that you can capture about your users.

    ii. Custom user properties: Custom data that you can capture about your users and send to the platform.


    You can have up to 120 user properties in User 360.

  2. User Events: Track specific actions or activities performed by users within a system, application, or platform. For more details, see User 360 events and Custom events

System user properties

System properties are the default user properties that contain the essential data organizations need to capture from their users. If you need to capture additional information, you can create custom user properties.

The following are the available system user properties, you can see these in User 360.

Property NameData TypeDescription
userIdstringUnique identifier for a user.
As per your setting, this could be a mobile number, email address, or any unique identifier. For more details, see here.
firstNamestringThe first name of the user
lastNamestringLast name of the user
genderstringGender of the user
countrystringCountry of the user. In bot conversation, it identifies this property based on the location of the user’s IP address
citystringCity of the user. In bot conversation, it identifies this property based on the location of the user’s IP address
languagestringPreferred language of the user
timezonestringIdentifies based on the location of user's IP address
emailemailEmail address of the user
phonephonePhone number of the user with country code
lastChannelstringRecent channel (set up on where the user had an active session
You can update this property to cover touch-points/channels outside
dobdateDate of birth of the user.
emailOptinbooleanSubscription status of the user to emails. The value is true if a user has subscribed to your emails, else it is false
smsOptinbooleanSubscription status of the user to SMS. The value is true if a user has subscribed to your SMS, else it is false
whatsAppOptinbooleanWhatsApp subscription status of the user. This is true if a user has subscribed to your WhatsApp messages, else it is false.
tagslistList of groups associated to the user. You can add tags to users manually.

UserId as a property

The userId is a unique property in the users schema and serves as an identifier for each user. It helps in recognizing users across multiple touch-points, capture and update user data. A userId can be any unique identifier such as phone number, email address, or any other external unique identifier such as driving licence number.

For more details, see:


Two records cannot have the same userId.

Tag as user property

A tag is a label used to categorise users based on certain characteristics or attributes. These labels can be used to segment customers into different groups for targeted marketing, sales, or customer service efforts. Some examples of customer labels include High-value, New customer, Inactive, or campaign responders.

A user can have more than one tag.

Custom user properties

Custom user properties refer to additional fields that you can create to capture information that is not covered by the default system properties. You can define these custom properties according to your business specific needs and requirements.

For instance, you might want to store details such as the number of times they have visited your pricing page, their department, and their preferred product.


Once a property is created, you cannot change its data type or delete it.

To create a new user property with your preferred label name and datatype, follow these steps:

  1. On the User 360 page, click User properties.

  2. Click on +Custom property

  3. In Property name, enter a name for the property.

  4. In Property type, choose the data type of the property.

The table lists the different datatypes supported for user properties.

Data TypeDescription
stringStores String data
numberStores positive or negative integer, or a decimal number
timeStores time in hh:mm:ss format
dateStores date in YYYY-MM-DD format
datetimeStores date and time in YYYY-MM-DD hh:mm:ss format
listStores an array of String values
booleanStores true or false
phoneStores phone numbers with country code and validates the format by checking country code and number of digits
urlStores URL and validates the format for the same
emailStores email and validates the format for the same
  1. To add more properties, click New property.

  2. Click Save.


Currently, you cannot modify or delete a custom property once created.