# List of contacts

The list opens from the bot's menu: "Lists" → "Contacts". The header shows how many contacts are found. The newest are at the top.

![Bot contact list: search, advanced filters and the contact table with tags](https://support.watbot.org/_media/en/01-chatbots/07-contacts/_images/list.webp?v=1791781230)

## What the list shows

| Column | What is in it |
|---|---|
| ID | The contact's number on the platform |
| "Name" | The name and avatar from the messenger. A click opens the [contact card](https://support.watbot.org/chatbots/contacts/card) |
| "Messenger" | The channel in which the person talks to the bot |
| "Phone" | The number, if the bot has received it or you have entered it in the card |
| "Username" | The username in Telegram |
| "Tags" | The contact's tags. They can be changed right in the list |
| UTM | The contact's variables whose names start with `utm_` — the tags of the ad link the person came by |
| "Referrer" | Who invited the contact. A click opens the inviter's card |
| "First activity" | When the contact appeared in the bot |

To add a tag to a contact, click "Add" in the "Tags" column, type the name and press Enter. The cross on a tag removes it. Changes are saved right away. More about tags is on the [Tags and variables](https://support.watbot.org/chatbots/contacts/tags-variables) page.

## Search

The field above the list searches by what its hint says — "ID, name, phone, username":

- by a part of the name;
- by the digits of the phone number — you do not have to remove spaces, brackets, hyphens and "+";
- by contact ID;
- by username in Telegram and MAX — start the query with the `@` sign, for example `@romashka`.

## Advanced filters

Expand "Advanced filters" under the search. A contact must match all the chosen conditions at once.

| Filter | Who matches |
|---|---|
| "Contact contains tags" | Contacts that have all the listed tags. No more than 20 tags |
| "Contact contains variables" | Contacts whose variable with that name equals the given value. The value is compared in full. No more than 20 variables |
| "Subscribed before" | Contacts that appeared in the bot earlier than the given date and time |
| "Subscribed after" | Contacts that appeared in the bot later than the given date and time |
| "Stopped the bot" | Contacts that have blocked the bot in the messenger |
| "Unsubscribed from mailings with the "stop" command" | Contacts that have unsubscribed from mailings |

The search and the filters work together. The chosen conditions are kept in the page address: a link to the filtered list can be bookmarked or sent to a colleague who has access to the bot.

How a person unsubscribes from mailings and what happens then is on the [Recipients and filters](https://support.watbot.org/chatbots/mailings/audience) page.

## Deleting contacts

There are three ways to delete a contact.

**One contact.** Click the bin icon in the row and confirm the deletion.

**Several ticked ones.** Tick the contacts with the checkboxes on the left and click the red "Delete …" button above the list.

**By conditions.** This is how you delete, for example, everyone who has blocked the bot:

1. Click "⋯" on the right above the list and choose "Delete".
2. In the "Delete contacts" window, set the conditions — the same as in the advanced filters. Click "Next".
3. The platform shows how many contacts will be deleted. Check the number and click "Delete".

> [!NOTE]
> Contacts can't be deleted without conditions: until at least one condition is set, the "Next" and "Delete" buttons are inactive. Still check the number at the second step.

Contacts can be deleted by conditions by the bot's owner or a team member with the "Deleting a bot" permission.

### What happens on deletion

- Together with the contact, their data is deleted: tags, variables and all accounts, even with a positive balance.
- A deleted contact cannot be restored. If the person writes to the bot again, they become a new contact and start the scenario from the beginning.
- For the contacts invited by the deleted one, the "Referrer" field in the card becomes empty.
- Deleted contacts are no longer counted in the bot's number of contacts.

The scenario can also delete a contact itself — with the ["Remove user from bot"](https://support.watbot.org/chatbots/blocks/contact-data/delete-contact) block.