> For the complete documentation index, see [llms.txt](https://help.roolz.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.roolz.net/en/contacts-and-people-search/people-search.md).

# People search

### **How to find a user that is not in your list of contacts?**

* **Nickname** is the easiest way to find a user. Nickname is unique. Search starts with 4 characters. Search query may partially match search results, which simplifies finding the right user.
* **Phone number or email** that is specified in the user profile or is used by the the searched user for authorization. The search query must exactly match the phone number or email.

### **How to find users from your contacts?**

There are 3 ways:

* **First and last name,** searches start at the 1st character match. For better results, enter the user's first and last names in full.

<div align="left"><figure><img src="/files/KihdGVGc0MPCBOHZuJxG" alt="" width="375"><figcaption></figcaption></figure></div>

* **Nickname,** search starts with 1 matching character.

<div align="left"><figure><img src="/files/bE6EgCNUm10oQ4RxiUL5" alt="" width="375"><figcaption></figcaption></figure></div>

* **Email or phone number search,** starts with matching 2 or more characters in a row.

<div align="left"><figure><img src="/files/ewehwWHwrymO09vNGZO1" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/O7SCnXIMyAUgSR0rlKP3" alt="" width="375"><figcaption></figcaption></figure></div>

### **Where to** search **for users?**

* There is a search field in the menu on the left above the list of chats. This is the most universal search that allows you to quickly find people and chats.

<div align="left"><figure><img src="/files/1L8xWD8WEhXiHM6cP9y1" alt="" width="375"><figcaption></figcaption></figure></div>

* Click on your profile picture (or the colored circle with the two letters) in the upper right corner. In the menu that appears, select "My Contacts". A list of your contacts will open, with a search option available for users, including those not in your contacts.

<div align="left"><figure><img src="/files/HvXY07HE6kjI0bpdJk8z" alt="" width="375"><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="/files/dlGXLkqo4JoSSQ0EEGky" alt="" width="375"><figcaption></figcaption></figure></div>

### **How to add users to your contacts?**

* In the [user profile](/en/user-profile/what-is-a-user-profile.md), click "Add to contacts".

<div align="left"><figure><img src="/files/6UkqxZifMyq9i00p6pXn" alt="" width="375"><figcaption></figcaption></figure></div>

* In the [chat](/en/messenger/full-guide.md) with the user, click "Add to contacts".

<div align="left"><figure><img src="/files/5dqZX9FjrwyYLiRkn1Bi" alt="" width="375"><figcaption></figcaption></figure></div>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.roolz.net/en/contacts-and-people-search/people-search.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.