> For the complete documentation index, see [llms.txt](https://support.hivo.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.hivo.co/people/searching-and-filtering-by-people.md).

# Searching and Filtering by People

The Library and Collections allow you to search and filter assets based on people identified in your images/videos:

* Click the down arrow on the search bar's right side.
* Select "**Face Detection**" from the options.

<figure><img src="/files/2sVayvC1jlBUsJkIt1Nm" alt=""><figcaption></figcaption></figure>

The following search and filtering options are available:

* Search by People
* Minium Face Count
* Match by Face&#x20;

### 1. Search by People

Use the **Search for People** field to search for and select one or more people. The search results will return assets containing the selected people.

When multiple people are selected, the search automatically returns only assets that contain **every selected person** (Requires all selected people to be present in the asset).&#x20;

**Example:**

* **Selected People:** John Smith, Jane Doe
* **Search Results:** Only assets containing both John Smith and Jane Doe are returned

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

### 2. Minimum Face Count

Use **Minimum Face Count** to specify the minimum number of detected people that must appear in an asset.

**Example**

* **0:** No minimum requirement.
* **2:** Returns assets containing at least two detected people.
* **3:** Returns assets containing three detected people.

This filter is useful when searching for group photos or images with multiple people.

<figure><img src="/files/3nVjBzeNgCujaYtp8Hwv" alt=""><figcaption></figcaption></figure>

### 3. Match by Face Size

Use the **Match by Face Size** slider to control the minimum size of detected people within an asset.

* **Any Size** (Default): Searches all images regardless of face size, proximity, or whether the person is far away or in the background.
* **Increase size**: Drag the slider to adjust the specific face size you want to search for.

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

### 4. Combine filters for more accurate results

All search options can be combined to narrow your results. Combining these filters helps you quickly locate the most relevant assets.

For example, you can:

* Search for one or multiple people.
* Specify a minimum number of people in the asset.
* Filter by the size of detected people.

To search for assets by people, ensure that people have already been identified, you first need to [**Add Person or Tagging Faces Directly in Assets**](https://app.gitbook.com/o/M6JZOAbIDYvbmtaZF3Gu/s/0sjg5GpIPr5HzBTJYqYe/~/changes/83/recognition/add-person-tagging-faces-directly-in-assets)**.**

If you have any questions, don't hesitate to ask, we're always here to help!


---

# 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://support.hivo.co/people/searching-and-filtering-by-people.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.
