Zean

Guides

Send custom attributes

Add the Contact’s city, order count or plan to their profile.

Updated October 18, 2026

The samples show app_your_app_key. Open this guide from App settings > Developers > Getting started to see your App’s key in them.

Custom attributes are details your app sends about the Contact, such as their city or number of orders. Your team sees them in the “Custom attributes” card of their profile.

window.zean.setAttributes({  city: "Douala",  orders: 12,  premium: true});

The rules

  • Each call adds to the attributes already sent: a key sent again replaces its value.
  • A name holds letters without accents, digits, _ and -, starts with a letter and has 40 characters at most.
  • A value is text of 250 characters at most, a number or a boolean.
  • A Contact has 50 attributes at most.
  • Some names are reserved, because the chat already shows them: id, name, email, user_id, external_id, verified, blocked, language, browser, os, app_version.
  • Attributes that break these rules are refused, and the console says why.

Attributes come from your app: they cannot be changed from the dashboard. Do not put sensitive data in them, such as a password or a card number.