> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/en/features/marketing/chatbot-2.0/custom-attributes-for-chatbot-add-on-feature.md).

# Custom Attributes for Chatbot (add-on feature)

Custom attributes can store customers' replies or personal data collected through API integration or customers' own input. This helps support your CRM system and gives you a better understanding of your customers.

Make sure to create the custom attribute on [this page](https://console.omnichat.ai/custom-attribute) before using it in chatbots. For a complete instruction, please refer to [this tutorial](https://en-docs.omnichat.ai/features/social-cdp/custom-attribute-cdp-subscription-plan-only).

### Chatbot Settings

Custom attributes can be collected by storing customer replies from chatbot question flows. This data helps you manage customers' personal details and preferences more effectively, and later run relevant marketing campaigns that better target your audience based on customer information.

To save a Custom Attribute in a card, you might need to fill in the following fields:

* Key: The name of the custom field
* Value: The value to be stored

The Value can be saved in different formats, as shown below:

* Text
* Number
* Date
* Date & Time
* Yes / No

We'll show you how to set custom attributes in applicable cards on WhatsApp, LINE and Facebook. You'll also see examples of how these attributes are collected in Omnichat console.

### Setting Custom Attributes in Chatbot Cards on WhatsApp, LINE, & Facebook

<table><thead><tr><th width="176.8515625">Platform</th><th width="259.70703125">Applicable Card</th></tr></thead><tbody><tr><td>Facebook, LINE</td><td><ol><li>Text Card</li><li>Carousel Card</li><li>Quick Reply Card</li><li>User Input Card</li></ol></td></tr><tr><td>WhatsApp</td><td><ol><li>Text Card</li><li>Option List Card</li><li>User Input Card</li></ol></td></tr></tbody></table>

{% hint style="info" %}

* You'll need to enter **Key and Value** in **Text Card**, **Carousel Card**, **Quick Reply Card**, and **Option List Card**.
* For the **User Input Card**, only **Key** is required.
  {% endhint %}

#### Example 1: Set Up Custom Attributes in a WhatsApp Text Card

In this example, the purpose is to collect the customer's **job title**.

1. Set up a Custom Attribute on [this page](https://console.omnichat.ai/custom-attribute).

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FAskdiqfYMs4Y0VXLUGqD%2F%E8%87%AA%E8%A8%82%E5%B1%AC%E6%80%A7%E5%85%88%E5%BB%BA%E7%AB%8B.png?alt=media&amp;token=a2c196b9-cfa0-4254-b71a-183537bad7ee" alt=""><figcaption><p>Set up a Custom Attribute First</p></figcaption></figure>

2. Set up button options in a text card for customers to choose from. E.g., "Coffee Shop Owner", "Waiter/Waitress", "Caffeine Addict".

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FJmtX8gZkR0YktEs1noJg%2F%E8%87%AA%E8%A8%82%E5%B1%AC%E6%80%A7card%20example.png?alt=media&amp;token=b0df9a59-3155-455c-b7db-83739244595b" alt=""><figcaption><p>Card Setting</p></figcaption></figure>

3. Set "Custom Attribute" in the "Additional Actions" section.
4. Select a preset Attribute Key (e.g., "Job Title") and enter the value you'd like to collect when the customer clicks the button (e.g., "Coffee Shop Owner", "Waiter/Waitress", "Others").

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2Fcgxw1Okyf4l5rfW9E5gN%2F%E8%87%AA%E8%A8%82%E5%B1%AC%E6%80%A7card%20%E8%A8%AD%E5%AE%9A.png?alt=media&amp;token=e28bff8b-929f-40f1-90e0-999b6e7d5db3" alt=""><figcaption><p>Custom Attributes Setting</p></figcaption></figure>

As you can see on the right side of the clip below, when the customer clicks the "Coffee Shop Owner" button, Omnichat system will automatically apply the attribute "Coffee Shop Owner" to this customer.

On the left side of the clip, you can see the attribute is stored in this customer's info panel in the conversation. You can also find the customer's collected custom attribute data in their [social contact profile](https://console.omnichat.ai/social-contact-management).

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FWMK6iojL7pq2QCbPYlqO%2FWhatsApp%20Custom%20Attribute.gif?alt=media&amp;token=f790facf-cf5c-48ae-b471-b349ab3545d2" alt=""><figcaption><p>How Custom Attribute Is Synced</p></figcaption></figure>

#### Example 2: Set Up Custom Attributes in a LINE User Input Card

In this example, the purpose is to collect the customer's **birthday**.

1. Set up a Custom Attribute on [this page](https://console.omnichat.ai/custom-attribute).

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F4KUIe3Lq9a5ahVxNLbYI%2F%E8%87%AA%E8%A8%82%E5%B1%AC%E6%80%A7%E7%94%9F%E6%97%A5.png?alt=media&amp;token=3b4dd501-f8e8-4da6-bd2a-94c3a503be7a" alt=""><figcaption><p>Set up a Custom Attribute First</p></figcaption></figure>

2. Set up a user input card, and select the preset custom attribute, "birthday", in the "Additional Actions" section.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FZRLawcnEHoOdvSfXvxw2%2F%E8%87%AA%E8%A8%82%E5%B1%AC%E6%80%A7userinput.png?alt=media&amp;token=2ca365f3-f450-4423-8c8b-df05c5f173fb" alt=""><figcaption><p>Custom Attributes Setting</p></figcaption></figure>

As you can see on the right side of the clip below, when the customer enters their birthday, Omnichat system will automatically capture this data to their profile.

On the left side of the clip, you can see the attribute is saved in this customer's info panel in the conversation. You can also find the customer's collected custom attribute data in their [social contact profile](https://console.omnichat.ai/social-contact-management).

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FDvWelmsyG8eeeh37Kko0%2F%E8%87%AA%E8%A8%82%E5%B1%AC%E6%80%A7user%20input.gif?alt=media&amp;token=b797fa3c-305b-433c-8758-9245ce8be2cf" alt=""><figcaption><p>How Custom Attribute Syncing Works</p></figcaption></figure>

#### Example 3: Set Up Custom Attributes in a Facebook Quick Reply Card

The purpose of this example is to collect information on whether this is the customer's first time attending the event.

1. Set up a Custom Attribute on [this page](https://console.omnichat.ai/custom-attribute).

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F41xpe2TCXaLGSvTNJOny%2FCustom%20Attributes%20FB%20setup.png?alt=media&amp;token=f23b0c74-ec7b-42e0-88b5-fa57d2c63704" alt=""><figcaption></figcaption></figure>

2. Set up a quick reply card, and select the preset custom attribute, "Is this your first time attending this event?", in the "Additional Actions" section.

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2FiAuQ6qngaRZK4Pp7IChG%2FSet%20Up%20Custom%20Attributes%20in%20a%20Facebook%20Quick%20Reply%20Card%202.png?alt=media&amp;token=253fd14b-b53f-4517-a8b8-9100b6b9c9b6" alt=""><figcaption><p>Custom Attributes Setting</p></figcaption></figure>

As you can see on the right side of the clip below, when the customer clicks the button "Yes", Omnichat system will automatically add this data to their profile.

On the left side of the clip, you can see the attribute is logged in this customer's info panel in the conversation. You can also find the customer's collected custom attribute data in their [social contact profile](https://console.omnichat.ai/social-contact-management).

<figure><img src="https://2848678129-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3u2I1osIy6mEi07X1z46%2Fuploads%2F9jhLZtr3DRRO8FCi4fgF%2Fcustom%20attribute%20FB.gif?alt=media&amp;token=e7915edc-3a71-433e-a27a-5e3edef1f1d9" alt=""><figcaption><p>How Custom Attribute Syncing Works</p></figcaption></figure>

{% hint style="warning" %}
**Important Notes When Using This Feature:**

* If the customer enters new data, it will replace the previously saved information.
* If the value entered by the customer doesn't match the required format, it won't be saved. For example, the supported formats for birthday are YYYY/MM/DD and YYYY-MM-DD. If a customer enters 2020\_01\_01, the attribute will not be saved.
  {% endhint %}