# Lists and labels

In the **Lists** section, you can create, edit, and use custom client lists for automation.\
Adding clients to a list can be automated based on bot flow steps — triggered by specific conditions or user actions.

Lists can be used to:

* Filter and segment clients within a project
* Export data

You can export a list as a file and import it into another MaviBot project.

<div data-with-frame="true"><figure><img src="/files/v7XWtX9w0w8tuuVKc1zs" alt=""><figcaption></figcaption></figure></div>

#### **Advantages of using lists:**

* **Automation:** Clients are automatically added to or removed from lists based on bot logic.
* **Portability:** Lists can be exported and imported between different projects.
* **Targeted communication:** Send broadcasts or specific funnel messages directly to filtered client lists.

Using lists streamlines audience segmentation and makes client interaction more precise and efficient.

## How to create a list

Lists are created in the **"Lists"** tab within the same section.

<div data-with-frame="true"><figure><img src="/files/28eaIFjdPTBOpahAFVGa" alt=""><figcaption></figcaption></figure></div>

Click the **"Create a list"** button to open a window with input fields where you can enter the list name and select a folder (if any exist) to add the list to.

<div data-with-frame="true"><figure><img src="/files/iZqLXMmUTlhgcx6dRPQl" alt=""><figcaption></figcaption></figure></div>

In the **"Lists"** section, you can sort the lists by List ID or alphabetically (by name):

<div data-with-frame="true"><figure><img src="/files/kgWb91GwREQgCkdQ0RWL" alt="" width="212"><figcaption></figcaption></figure></div>

The power of client lists lies in their flexibility. You can, for example, add a single client to **multiple lists simultaneously**.

Lists can be:

* Grouped into folders
* Renamed
* Deleted (the clients themselves remain in the database)
* Used to **remove all clients within a list** from the project

<div data-with-frame="true"><figure><img src="/files/QG6CVNLin8bRFSjROccD" alt="" width="563"><figcaption></figcaption></figure></div>

You can include or exclude clients by applying filter types — either manually via a form or by uploading a file.

To view the clients within a list:

1. Click on the list to open the right-side menu.
2. Click the **"View client list"** button.

<div data-with-frame="true"><figure><img src="/files/HJLZQlEoMbKw3JDEbSvA" alt="" width="563"><figcaption></figcaption></figure></div>

Then a new window will open from the **"Clients"** section, where you can view all users in that list.

## How to automate your work with lists

You can automatically add, remove, or move clients between lists while the chatbot is running.

Find the set of **list actions** in any block of the builder:

<div data-with-frame="true"><figure><img src="/files/GdEyXcEilqGZDOFQVl7N" alt=""><figcaption></figcaption></figure></div>

When the **"Action"** section is enabled, you can choose which actions to perform on your lists.

<div data-with-frame="true"><figure><img src="/files/hNRbgsjCrD8DDtaBM0OZ" alt="" width="375"><figcaption></figcaption></figure></div>

After selecting an action, you can choose which specific list to apply it to. You can also specify multiple different actions within the same block—there is no limit to the number of actions you can add in one block.

<div data-with-frame="true"><figure><img src="/files/2yqosNQmHU3phArmY6ZW" alt="" width="375"><figcaption></figcaption></figure></div>

Commands are executed in the order they appear in the block settings.

### Checking if a person is on the list

To <mark style="color:green;">**check if a client is in the list**</mark>, you can use the <mark style="color:green;">**`inlist (list_number)`**</mark> function in the **"Variable"** field for comparison within blocks and connection.

The result of the function execution is a Boolean value (True or False).

`inlist(list number) == True  -` the client IS in the list or

`inlist(list number) == False -` the client is NOT in the list.

<figure><img src="/files/BvVdCpoyFyEu7Fnfrpmr" alt=""><figcaption></figcaption></figure>

The list number can be found by clicking on the required list. In this case, the right menu opens with information about the list:

<div data-with-frame="true"><figure><img src="/files/0wtNlfaIuMdlkd68qeL4" alt=""><figcaption></figcaption></figure></div>

### Other list-related functions

{% hint style="info" %}
[You can find the etailed instructions for working with list and tag functions here.](/chatbot/functions/calculator/lists.md)
{% endhint %}

## **How to work with lists manually**

Each list has buttons to:

* Add/remove clients from the list
* Launch a mailing based on the list
* Download the list as a file

The context menu includes options to:

* Add the list to a folder
* Edit the list
* Delete the list (clients remain in the project)
* Remove all clients in the list from the project

{% hint style="danger" %}

#### **Warning**

**"Remove list members from the project"** permanently deletes those clients from the project. This action cannot be undone.
{% endhint %}

### Add clients to a list

<div data-with-frame="true"><figure><img src="/files/TWp9WeImlsS2MYAdNzEO" alt="" width="375"><figcaption></figcaption></figure></div>

You can manually add **existing clients** to a list by filtering them through a form, uploading a file, or selecting from another list.

{% hint style="warning" %}

#### Important

When adding existing clients to a list **from a file**, the first column must contain the **internal client IDs** (the `client_id` variable).
{% endhint %}

#### How to add clients from a file:

1. Select the **"Clients from a file"** filter type:

<div data-with-frame="true"><figure><img src="/files/cp9pKRll2mdXZls8CNt0" alt="" width="375"><figcaption></figcaption></figure></div>

2. Next, upload a client list in .CSV format

<div data-with-frame="true"><figure><img src="/files/kX4d719sZWEFnE6pVDGV" alt="" width="375"><figcaption></figcaption></figure></div>

To <mark style="color:green;">**add NEW clients**</mark> to a specific list, go to the **"Channels"** section. Then click the **"Upload client list"** button and select the list you want to upload clients to.

### How to remove clients from a list

You can remove clients from a list in the same way: click the **"— Remove from list**" button and apply filters if needed.

<div data-with-frame="true"><figure><img src="/files/GVjDTqm1r9TJF0VdeXwM" alt="" width="375"><figcaption></figcaption></figure></div>

Apply the necessary filters to remove a specific group of clients **FROM THIS LIST** (not from the client database).

{% hint style="danger" %}
**Please be careful when filling out the form.**

If you leave the filter fields in the **"Remove from list"** form **empty**, **all clients** in that list will be removed.

To remove only a portion of the list, fill in the relevant filters:

* **By connected messengers** — select a specific bot
* **Clients in a block** — specify the block number(s) in the funnel (multiple blocks can be added)
* **By client variables** — enter an exact variable value
* **Registered before/after** — set the relevant date range
* **Exclude lists** — if list numbers are entered, only clients **not** present on any of those exclusion lists will be removed from the current list.
  {% endhint %}

## How to create a mailing

When you click on the list, you will also see the **"Create a mailing"** button in the right sidebar.

<div data-with-frame="true"><figure><img src="/files/YMPn1LqaF8yGedwc3Obw" alt="" width="563"><figcaption></figcaption></figure></div>

You can create a mailing for both **messengers** and **email** (if email is enabled in your project).

## How to transfer client from other platforms

When uploading clients from other platforms in the **"Messengers"** section, you can select one or more lists where the clients will be placed after upload.

To do this:

1. Go to the **"Messengers"** section.
2. Select the connected messenger where you want to upload the clients.

<div data-with-frame="true"><figure><img src="/files/NHvJPeQAoYDhRAO0RNNO" alt=""><figcaption></figcaption></figure></div>

Click the **"Upload clients"** button and configure the upload settings (encoding, destination list, etc.) to import your list.

<div data-with-frame="true"><figure><img src="/files/HQANtls7BJYi8HWlES2J" alt="" width="563"><figcaption></figcaption></figure></div>


---

# 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://docs.mavibot.ai/crm/tags.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.