Custom Attributes
Custom Attributes let you define additional contact fields specific to your WhatsApp use case — beyond the standard fields like name, email, and phone. These attributes can store any data that matters to your business and can be used to personalize WhatsApp template variables.
Navigating to Custom Attributes
- Go to Settings → Channels → WhatsApp.
- Click the Custom Attributes tab.
The Custom Attributes tab is in the WhatsApp channel settings.
Why Use Custom Attributes?
Standard contact fields (First Name, Email, Phone, Company, etc.) cover most use cases, but some businesses need to track WhatsApp-specific data such as:
- Loyalty tier (Gold, Silver, Bronze)
- Last order number
- Preferred language
- Subscription plan
- Appointment confirmation status
Custom attributes give you the flexibility to store and use this data in templates and automations.
Creating a Custom Attribute
- Click + Add Attribute.
- Fill in the attribute details:
| Field | Description |
|---|---|
| Attribute Name | A human-readable label (e.g., "Loyalty Tier") |
| Attribute Key | Auto-generated snake_case key used in templates (e.g., loyalty_tier) |
| Data Type | Text, Number, Date, Boolean (True/False), or List |
- Click Save.
Create a custom attribute with a name, auto-generated key, and data type.
Editing Attribute Values on a Contact
After creating a custom attribute, it appears on every contact's record in the Custom Fields section:
- Open a contact record.
- Scroll to the Custom Fields section.
- Find the custom attribute and click its value to edit it.
- Enter the value and save.
Set custom attribute values per contact on their contact record.
Using Custom Attributes in Templates
Custom attribute keys can be used as template variable values in the variable mapping panel when sending:
- Open the template picker and select your template.
- In the variable mapping panel, choose Custom Field from the dropdown.
- Select the custom attribute key (e.g.,
loyalty_tier).
The value for that contact will be automatically inserted into the template at send time.
Select a custom attribute key to populate a template variable with contact-specific data.
Managing Attributes
Editing an Attribute
Click the Edit (pencil) icon on an attribute row to update the name or data type. The attribute key cannot be changed after creation.
Deleting an Attribute
Click the Delete (trash) icon to permanently remove an attribute. This also removes all values stored for that attribute across all contacts.
Edit or delete attributes from the attribute list.