# Custom attributes

## Custom attributes list

Custom attributes — additional attributes that can be assigned to a Conversation or Contact.

<figure><img src="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2F5LmkR0MDdq1DEvUeG73q%2Fimage.png?alt=media&#x26;token=f88f97de-683a-4be2-9f12-dc456e7244ca" alt=""><figcaption></figcaption></figure>

In the Custom Attributes section for Conversation/Dialogue/Contact, two subsections are available:

* **Active** - displays a list of active attributes;
* **Deleted** - displays a list of deleted attributes.

In the Active section, you can edit existing attributes and create new ones.&#x20;

In the Deleted section, you can restore deleted attributes.

To create a new attribute/edit an existing one, select **Add Custom Attribute/Edit Custom Attribute.**

***

### Create/Edit a Custom Attribute

<figure><img src="https://2498134934-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5yF7NRiGknx3Bqj4OgYA%2Fuploads%2FJoP6EFhgrkDrNJZqycVC%2Fimage.png?alt=media&#x26;token=ddc5413b-f01a-48cb-88aa-02909b9c8dde" alt=""><figcaption></figcaption></figure>

1. **Applies to** - Selection of the entity to which the attribute applies: Conversation, Dialogue, or Contact.&#x20;
2. **Display Name**
3. **Key**&#x20;
4. **Description**&#x20;
5. **Type**

<table><thead><tr><th width="253">Attribute type</th><th>Possible values</th></tr></thead><tbody><tr><td>Text</td><td>Any values</td></tr><tr><td>Number</td><td>Only numbers</td></tr><tr><td>Link</td><td>Link</td></tr><tr><td>Date</td><td>Date selection</td></tr><tr><td>List</td><td>Selecting a value from a created list of possible values</td></tr><tr><td>Checkbox</td><td>True or False value selection</td></tr></tbody></table>

{% hint style="info" %}
Attributes can be added to a **Conversation**, **Dialogue**, or **Contact** by:

* Using the logic of the [Chatbot](https://help.novatalks.com.ua/en/get-started/settings/chatbots);
* Manually by an agent.&#x20;
  {% endhint %}

### System custom attributes of a Contact

The system has the following system custom attributes of a Contact:

<table><thead><tr><th>Name</th><th>Key</th><th width="191">Description</th><th>Type</th></tr></thead><tbody><tr><td>Language</td><td>language</td><td>language</td><td>List</td></tr><tr><td>URL</td><td>browser_link</td><td>browser_link</td><td>Link</td></tr><tr><td>UTM Source</td><td>utm_source</td><td>utm_source</td><td>Text</td></tr><tr><td>UTM Medium</td><td>utm_medium</td><td>utm_medium</td><td>Text</td></tr><tr><td>UTM Campaign</td><td>utm_campaign</td><td>utm_campaign</td><td>Text</td></tr><tr><td>UTM Content</td><td>utm_content</td><td>utm_content</td><td>Text</td></tr><tr><td>UTM Term</td><td>utm_term</td><td>utm_term</td><td>Text</td></tr><tr><td>OS</td><td>OS</td><td>OS</td><td>Text</td></tr><tr><td>Browser</td><td>browser</td><td>browser</td><td>Text</td></tr><tr><td>IP</td><td>ip</td><td>ip</td><td>Text</td></tr><tr><td>Country</td><td>country</td><td>country</td><td>Text</td></tr></tbody></table>

{% hint style="info" %}
System custom attributes of a Contact are used to record information about a customer who has contacted from the Website channel (More information - [Online chat and website widget](https://help.novatalks.com.ua/en/get-started/settings/inboxes/website))
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.novatalks.com.ua/en/get-started/settings/custom-attributes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.