---
title: 'Face detection'
description: 'Recognize the people in your images and videos by name, review and confirm detected faces, tag people manually and search for files by person.'
url: https://www.medialab.co/support/core/metadata/face-detection
---

# Face detection

Face detection recognizes the people in your images and videos, so you can find every file a specific person appears in. Faces are matched against a set of trained faces of the people that matter to your organization, such as presenters, players, executives or spokespeople.

Face detection is available as an add-on and uses an external face recognition service. [Contact us](https://www.medialab.co/contact) to set it up for your account.

### How detection runs

- **Automatically**: administrators can have face detection run on every new upload, separately for images and videos.
- **On request**: run the **Detect faces** workflow on selected files or a whole folder, for example to process files that were uploaded before face detection was switched on.

Detection runs in the background. You receive a notification when new faces are found in a file.

For images, a detected face is shown with a box around it. For videos, MediaLab shows when a person appears, for example "Appears at 12s, 40s".

### Viewing people in a file

Open a file and look under **People** in the info panel. Every person found in the file is shown with their picture or initial. Faces that still need to be reviewed are greyed out and marked **(unconfirmed)**.

### Reviewing detected faces

Users who can manage faces click a person under **People** (or **Manage people**) to review the faces in a file:

- **Needs review**: faces that were detected but not yet confirmed. Enter or check the person's name and click **Confirm**, or click **Reject** if the match is wrong. Confirming with a new name adds that person.
- **Confirmed**: the people confirmed in this file. Click **Remove** to remove someone from the file.
- **Tag a person**: add someone the detection missed. Enter a **Person name** and click **Add**.

Administrators can have matches confirmed automatically when the detection is confident enough, so only uncertain matches need a review.

### Managing people

Click **Manage faces** in the review window to open the overview of all **People**, with the number of faces found for each.

- **Rename** a person with the edit button. A name you set is never overwritten by a later detection.
- **Delete** a person to hide them from all files and stop recognizing them in new detections. Deleted people can be brought back with **Restore**, including all their faces. Filter on **Deleted** to find them.

### Searching by person

In **Search**, use the **Recognized person** filter to find all files with a confirmed face of a person, or **Face status** to find faces that **Need confirmation**, are **Confirmed** or were **Rejected**. Save the search to create a [smart collection](https://www.medialab.co/support/core/organizing-media/collections), for example of all files showing your CEO.

### Settings

Administrators find the face detection settings under **Settings → Extensions → Face detection**:

- **Automatically run face detection**: on new uploads of **Image files** and/or **Video files**.
- **Auto-confirm minimum confidence**: matches at or above this confidence (0-100) are confirmed automatically. Leave it empty to review every match.
- **Import anonymous faces**: also add faces in images that don't match a known person.
- **Manage trained faces**: manage the set of known people that faces are matched against.

### Who can use it

| Permission | What it allows |
|---|---|
| **View faces** | See the people detected in files, and search by person. |
| **Manage faces** | Confirm, reject, tag and remove faces, and manage people. |

Media managers, administrators and owners have both permissions. Uploaders and users need them to be granted in their permissions.

### Privacy

Faces can be used to identify people, so they are personal data, and recognizing people by their face is subject to strict rules in many countries, including the GDPR in the EU. Make sure your organization has a valid basis for using face recognition before switching it on, and only train the faces of people for whom you have one.

- To analyze a file, it is sent to the external face recognition service. The trained faces are kept by that service.
- Removing a face from a file or deleting a person hides them, but it can be undone. Contact support if data needs to be removed permanently.
- When a file is deleted, its detected faces are removed with it.

### Using the API

Integrations can read and manage faces and people through the `/api/files/{file_id}/faces` and `/api/faces/persons` methods. See the [API methods](https://www.medialab.co/developers/methods) for full details.

### References

- [AI metadata detection](https://www.medialab.co/support/core/metadata/ai-metadata-detection)
- [Collections and smart collections](https://www.medialab.co/support/core/organizing-media/collections)
- [User flags](https://www.medialab.co/support/account/roles-permissions/user-flags)
