Skip to main content

How to use contact attributes in Wati

Summary

Contact Attributes let you store additional information about your contacts, such as customer preferences, campaign sources, membership plans, order IDs, or internal notes. You can use this information to organize your contacts, create targeted campaigns, personalize messages, and build automation workflows.

Unlike Tags, Contact Attributes are stored on contacts, not conversations. This guide explains how to add Contact Attributes, manage them, and follow best practices to keep your contact data organized.

Important: Contact Attributes are designed for contact segmentation and personalization. If you only need to categorize or search conversations, use Tags instead.

Instructions

What are Contact Attributes?

Contact Attributes are custom fields that store additional information about a contact.

For example, you can store information such as:

  • Customer preferences

  • Campaign sources

  • Membership plans

  • Order IDs

  • Internal notes

Because Contact Attributes are stored on contacts, they can be used for:

  • Contact segmentation

  • Campaign targeting

  • Message personalization

  • Automation workflows

Add Contact Attributes from the Contacts page

Follow these steps to add a Contact Attribute to a contact.

Step 1: Select a contact

  • Log in to your Wati account.

  • Go to Contacts.

  • Search for or select the contact you want to update.

  • Click the Edit icon next to the contact.

Step 2: Add a Contact Attribute

  • Go to the Contact Attributes section.

  • Click + Add Attribute.

  • Select + ADD NEW.

  • Enter:

    • Attribute name (for example, plan_type or campaign_source)

    • Attribute value (for example, premium or facebook_ads)

Use clear and descriptive names so the purpose of each attribute is easy to understand.

Step 3: Save your changes

  • Review the information.

  • Click Save Changes.

The Contact Attribute is now saved to the contact and can be used for segmentation, campaigns, personalization, and automation.

Add Contact Attributes from the Team Inbox

You can also add or update Contact Attributes while viewing a conversation in the Team Inbox.

To edit a contact's attributes:

  • Log in to your Wati account.

  • Go to Team Inbox.

  • Open the contact's conversation.

  • In the contact details panel on the right, click the Edit (✏️) icon.

  • Add or update the required Contact Attributes.

  • Save your changes.

Manage Contact Attributes

Workspace admins can manage all Contact Attributes from the Tags and Attributes settings.

To manage Contact Attributes:

  • Click your profile icon in the upper-right corner of your Wati account.

  • Select Settings.

  • Go to Tags and Attributes.

  • Select the Attributes tab.

From this page, you can:

  • View all existing Contact Attributes.

  • Search for an attribute by typing its name in the search box. Matching attributes appear as you type.

  • Edit or delete existing Contact Attributes.

  • Create a new Contact Attribute. If no matching attribute exists, click Add Attribute to create one.

Best practices

Follow these recommendations to keep your contact data organized:

  • Use clear and descriptive attribute names.

  • Keep attribute values short and relevant.

  • Follow a consistent naming convention, such as lowercase letters with underscores (for example, order_id).

  • Avoid creating duplicate or unnecessary Contact Attributes.

  • Review and update Contact Attributes regularly.

Store multiple values correctly

Each Contact Attribute must have a unique name. If you reuse the same attribute name, the value may be overwritten.

Correct example

Use a different attribute name for each value:

broadcast_1 = white 
broadcast_2 = blue

Both values are stored separately.

Incorrect example

Do not reuse the same attribute name:

broadcast = red 
broadcast = yellow

Only one value is retained, and the other value may be overwritten.

When to use Contact Attributes?

Use Contact Attributes when you want to:

  • Track customer preferences.

  • Store order numbers or reference IDs.

  • Segment contacts for targeted campaigns.

  • Personalize automated messages.

  • Store internal information about a contact.

If you only need to organize conversations or search chats by topic, use Tags instead.

Contact Attribute limits

The maximum number of custom Contact Attributes available depends on your Wati subscription plan.

Plan

Maximum custom Contact Attributes

Growth

50

Pro

100

Business

500

These limits define the maximum number of custom Contact Attributes available in your Wati workspace.

Frequently Asked Questions (FAQs)

General

1. What are Contact Attributes in Wati?

Contact Attributes are custom fields that store additional information about a contact, such as customer preferences, campaign sources, membership plans, order IDs, or internal notes. They can be used for contact segmentation, campaign targeting, message personalization, and automation workflows.

2. Are Contact Attributes stored on contacts or conversations?

Contact Attributes are stored on contacts, not conversations.

3. When should I use Contact Attributes instead of Tags?

Use Contact Attributes when you want to segment contacts, target campaigns, personalize messages, build automation workflows, or store customer-specific information. If you only need to categorize or search conversations, use Tags instead.

Managing Contact Attributes

4. What can I do from the Contact Attributes page?

From Settings > Tags and Attributes > Attributes, workspace admins can:

  • View all existing Contact Attributes.

  • Search for Contact Attributes.

  • Edit or delete existing Contact Attributes.

  • Create new Contact Attributes.

5. How should I name Contact Attributes?

Use clear and descriptive names, keep values short and relevant, follow a consistent naming convention such as lowercase letters with underscores (for example, order_id), avoid duplicate or unnecessary Contact Attributes, and review them regularly to keep your data organized.

6. Can multiple Contact Attributes have the same name?

No. Each Contact Attribute must have a unique name. If the same attribute name is used more than once, one value may overwrite the other.

Limits

7. How many custom Contact Attributes can I create?

The number of custom Contact Attributes depends on your Wati subscription plan:

  • Growth: 50 Contact Attributes

  • Pro: 100 Contact Attributes

  • Business: 500 Contact Attributes

Did this answer your question?