> 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/add-person-and-tagging-faces-directly-in-assets-1.md).

# Add Person and Tagging Faces Directly in Assets

The **People** feature allows you to create and manage **People Profiles** for individuals appearing in your images and videos. Once a detected person has been assigned to a **People Profile**, they become searchable using **Search by Person** across your Library and Collections.

Before assigning people to your assets, ensure that **People Detection** has been run on the assets you want to manage. People Detection identifies people within images and videos and displays bounding boxes that can be assigned to People Profiles.

## 1. Create a People Profile

Administrators can manually create a new **People Profile** for someone they want to track across their asset library.

* Navigate to **People** -> Click **Add Person**.
* Enter the person's details.
* (Optional) Add Metadata to improve organisation and search.
* Click **Submit**.

The new People Profile is now available for assigning to detected people in your assets.

👉 **Note:** Depending on your **Recognition Settings**, HIVO can automatically create **Anonymous People** when the same unidentified person appears multiple times. The minimum number of appearances required is configurable in **Recognition Settings**.

{% @howdygo/embed url="<https://app.howdygo.com/share/ad7a438d-a4ed-44d8-bf63-2cc5eed837c6>" %}

## 2. Assign People to Assets

Users with the **Can Tag Faces on Assets** permission can assign detected people directly from an asset.

* Navigate to the **Library,** then open the image or video you want to manage.
* Hover over a detected person to display the bounding box.
* Click the bounding box:
  * If the person has not been assigned to the asset, or the system could not recognize and automatically assign them because your organization has enabled [**Disable Recognition Vectors**](https://support.hivo.co/client-profile/client-profile-settings/asset-and-metadata-management/recognition-settings#option-1-disable-recognition-vectors).
  * If the face has already been assigned, select **Reassign** to link it to a different **People Profile**.

Once assigned, the detected person becomes linked to that People Profile. Multiple People Profiles can be assigned to the same asset when multiple people appear in an image or video.

Once a detected person has been assigned to a **People Profile**, you can use **Search by Person** to quickly find all related assets across your Library and Collections.

{% @howdygo/embed url="<https://app.howdygo.com/share/7b0c9742-6093-4835-90fd-5ef87f6f2b96>" %}

👉 **Note: Face Tagging Permissions on Assets**

Users with the Can Tag Faces on Assets permission can assign detected people directly from an asset. Depending on your specific permission level:

* **'Can Tag Faces on Asset'** permission: You must have Full Access to the specific asset to tag faces.
* **'Can Tag Faces in Any Asset'** permission: You can tag faces on any asset, even without individual permission or access rights to that asset.

<figure><img src="/files/07RCU0YPM1gB5sNWvi6W" alt=""><figcaption></figcaption></figure>

***

## How Recognition settings affect People

Recognition Settings determine how detected people are processed after **People Detection** runs.

Depending on your configuration:

* **Disable Recognition Vectors** prevents automatic face matching while still allowing people to be detected and assigned manually.
* **Only Track Known Faces** only tracks people who already have a People Profile. Unknown people are not stored as Anonymous People.
* **Manual Confirmation Required for Known Faces** sends potential matches to **People Approvals** for review before they are assigned to a People Profile.

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

Regardless of your Recognition Settings, only people that have been assigned to a **People Profile** can be found using **Search by Person**.


---

# 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/add-person-and-tagging-faces-directly-in-assets-1.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.
