> 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/run-people-detection.md).

# Run People Detection

HIVO streamlines the asset tagging process by automatically detecting people in uploaded assets, making it easier to identify, organize, and search for people across your library. Users can run people recognition **during the upload** process or **directly within the library via Actions.**

### 1. Run People Detection during Upload

Enable "**Face Detection**" under Automations in the Uploader's Asset Details step. This will automatically detect faces during upload.

<figure><img src="/files/Nf2rnEcRgqiWp8EHRxGz" alt=""><figcaption><p>Face Detection</p></figcaption></figure>

### 2. Run People Detection from the Library

* Navigate to the [**Libary**](/library.md), select the assets you want to process.
* Then Click "[**Actions**](https://support.hivo.co/library/library-actions)**"**&#x20;
* Enable **Detect Faces** and click **Submit.** HIVO will process the selected assets in the background and detect people automatically.

HIVO will process the selected assets in the background. Once processing is complete, detected people will appear as bounding boxes on the [**Asset Details**](/assets/asset-detail-page.md) page, where you can assign them to existing [**People Profiles**](/people/add-person-and-tagging-faces-directly-in-assets.md) or create new ones.

<figure><img src="/files/ZgJryH1hozm8dNKcJvcG" alt=""><figcaption><p>Detect Face with Existing Assets</p></figcaption></figure>

#### 👉 Important Notes

* The accuracy of People Detection depends on your [**Recognition Settings**](/client-profile/client-profile-settings/asset-and-metadata-management/recognition-settings.md), including the configured face size, confidence, similarity, and grouping thresholds.
* Running **People Detection** only detects people within your assets. A detected person will only become searchable after being assigned to a **People Profile**.
* If [**Manual Confirmation Required for Known Faces**](https://support.hivo.co/client-profile/client-profile-settings/asset-and-metadata-management/recognition-settings#option-3-manual-confirmation-required-for-known-faces) is enabled, suggested matches must first be reviewed and confirmed through [**People Approvals**](/approvals/people-approvals.md) before they become searchable.

Once people have been assigned to **People Profiles**, you can use [**Search by Person**](/people/searching-and-filtering-by-people.md) to quickly find assets containing specific people across your Library and Collections.

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/run-people-detection.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.