Store any data you need about contacts and conversations
Create custom fields to capture business-specific information. Track subscription plans, account IDs, preferences, and any other data that matters to your team.
Flexible data fields for any use case
Create attributes for contacts and conversations with support for multiple data types.
Supports all the data types you need
Choose from text, numbers, dates, lists, checkboxes, and links to capture any information.
Text
Free-form text input for any string data.
Example: Company name, notes
Number
Numeric values for quantities and amounts.
Example: Contract value, user count
Date
Date fields for tracking important dates.
Example: Renewal date, signup date
List
Dropdown selection from predefined options.
Example: Plan type, priority level
Checkbox
Boolean true/false values.
Example: VIP status, opt-in flags
Link
URLs and external references.
Example: CRM link, documentation
Contact Attributes
Persistent data tied to a contact
Store information that belongs to a contact across all their conversations. This data persists and is visible whenever you interact with them.
Conversation Attributes
Data specific to each conversation
Track information unique to a specific conversation. Different conversations with the same contact can have different values.
Use attributes in automations and integrations
Custom attributes aren't just for display. Use them to trigger automations, filter contacts in segments, and sync data with external tools via API.
- Trigger automations when attributes change
- Use attributes as conditions in automation rules
- Filter contacts in segments by custom attributes
- Set attributes automatically via automation actions
- Sync attributes with external systems via API
- Pass attributes to webhooks for integrations
// Update contact attributes
await chatwoot.contacts.update(contactId, {
custom_attributes: {
plan: "enterprise",
account_id: "ACC-2847",
contract_value: 24000,
renewal_date: "2026-03-15"
}
});Capture the data that matters to your business
Custom attributes give you the flexibility to track any information about your contacts and conversations.