> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getjumper.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Using face detection

> Step-by-step guide to detecting faces, naming people, and searching for them in your footage

<Info>
  This feature requires a Jumper Pro license
</Info>

This guide walks you through the process of detecting faces in your footage, organizing them into collections, and searching for specific people. For an overview of how face detection works and what Collections are, see [Face detection](/core-concepts/face-detection).

## Detecting faces in media

To detect faces in a media file, you need to mark the media file for face detection in the [Media tab](/interface/media-tab) (tick the checkbox in the `Mark for face detection` column) and choose a Collection to add the faces to.

<img src="https://mintcdn.com/jumper/6H-1x4UQQQa2zrKw/images/face_detection_6.avif?fit=max&auto=format&n=6H-1x4UQQQa2zrKw&q=85&s=da23b5ea257dac4cde07d292f58ceab7" alt="face_detection_6.avif" width="1200" height="955" data-path="images/face_detection_6.avif" />

By clicking the dropdown menu, you can choose a Collection or create a new one.

<img src="https://mintcdn.com/jumper/6H-1x4UQQQa2zrKw/images/face_detection_7.avif?fit=max&auto=format&n=6H-1x4UQQQa2zrKw&q=85&s=f2de3a857656faa9c3c234fd2b6addb5" alt="face_detection_7.avif" width="1200" height="955" data-path="images/face_detection_7.avif" />

## Viewing detected faces

Once the media file has been analyzed, you can see your collection of faces in the [People tab](/interface/people-tab). By default, all people are unnamed.

With default settings, the People Grid shows all the people that occur in <Tooltip headline="Required sample time" tip="This varies slightly depending on the grouping setting">at least 5 seconds</Tooltip> of footage.

<img src="https://mintcdn.com/jumper/6H-1x4UQQQa2zrKw/images/face_detection_2.avif?fit=max&auto=format&n=6H-1x4UQQQa2zrKw&q=85&s=546de19c09381b28c9c7117d56fb1126" alt="face_detection_2.avif" width="1200" height="715" data-path="images/face_detection_2.avif" />

## Naming people

To assign a name to a person, click the name field and type the name.

<img src="https://mintcdn.com/jumper/6H-1x4UQQQa2zrKw/images/face_detection_3.avif?fit=max&auto=format&n=6H-1x4UQQQa2zrKw&q=85&s=e545e1a8f48d01a08c9fa26243fd42f2" alt="face_detection_3.avif" width="1200" height="715" data-path="images/face_detection_3.avif" />

<img src="https://mintcdn.com/jumper/6H-1x4UQQQa2zrKw/images/face_detection_8.avif?fit=max&auto=format&n=6H-1x4UQQQa2zrKw&q=85&s=acbbf0f728d8a46746bc18705bee20a8" alt="face_detection_8.avif" width="1200" height="967" data-path="images/face_detection_8.avif" />

After assigning a name, that person becomes searchable in the [Search tab](/interface/search-tab).

## Searching for people

To search for a person, click the Face icon button to bring up a list of all named people and select the person you want to search for.

<Info>
  Pro tip: You can also type '@' in the search bar to bring up the People dropdown.
</Info>

<img src="https://mintcdn.com/jumper/6H-1x4UQQQa2zrKw/images/face_detection_4.avif?fit=max&auto=format&n=6H-1x4UQQQa2zrKw&q=85&s=08251db23c4bf89c0caf80a8c871bf62" alt="face_detection_4.avif" width="1200" height="715" data-path="images/face_detection_4.avif" />

You can now search for any keywords or context and Jumper will find scenes of that person with the search query.

<img src="https://mintcdn.com/jumper/6H-1x4UQQQa2zrKw/images/face_detection_5.avif?fit=max&auto=format&n=6H-1x4UQQQa2zrKw&q=85&s=880d03b723fbad6e3722c59b0a4c6a92" alt="face_detection_5.avif" width="1200" height="715" data-path="images/face_detection_5.avif" />

### Multi-person search

Select multiple named people from the Face search control to narrow results by cast or interview participants.

| Mode    | Finds                                                       |
| :------ | :---------------------------------------------------------- |
| **AND** | Shots where every selected person appears in the same frame |
| **OR**  | Shots where any of the selected people appear               |

Combine people filters with a visual search query. For example, select **Anna** and **Ben** with **AND**, then search for `walking outside` to find exterior shots of both people together.

## Merging groups

Occasionally, Jumper might create multiple groups for the same person. This is because the face detection algorithm might have low confidence in the detection.

You can merge any group with any already named person by clicking the <Icon icon="merge" /> button on a group and selecting the person you want to merge it with.

## Regrouping faces

If you are not happy with the grouping of the faces, you can regroup them with different parameters to improve the accuracy of the grouping.

You can regroup faces by clicking the ellipsis button (<Icon icon="ellipsis-vertical" />) next to the collection name and selecting `Regroup` in the [People tab](/interface/people-tab).

<img src="https://mintcdn.com/jumper/QKsEHmLCi1p88qcZ/images/regroup-collection-dialog.png?fit=max&auto=format&n=QKsEHmLCi1p88qcZ&q=85&s=9909258f3300b0267c73118329e5cd88" alt="regroup-collection-dialog.png" width="1146" height="984" data-path="images/regroup-collection-dialog.png" />

In the dialog, set the **Grouping strictness**. The scale runs from loose to strict. The stricter the setting, the more similar faces must be before Jumper groups them together.

| Level                  | Behavior                                                |
| ---------------------- | ------------------------------------------------------- |
| **Very Loose**         | Faces that look different may be grouped together.      |
| **Loose**              | Faces that look somewhat similar are grouped together.  |
| **Balanced** (default) | Faces are grouped by reasonable similarity.             |
| **Strict**             | Faces that look similar are grouped together.           |
| **Very Strict**        | Faces must be very similar to be grouped together.      |
| **Ultra Strict**       | Faces must be extremely similar to be grouped together. |

A looser setting collects more appearances of the same person but risks mixing people who look alike. A stricter setting keeps people apart but may split one person into several groups, which you can fix by [merging groups](/guides/face-detection#merging-groups).

### Remove all assigned names

You can choose whether to preserve existing names when regrouping:

* **Off (default)**: Already assigned names will be preserved. Only unassigned faces will be regrouped.
* **On**: All assigned names will be removed before regrouping. This gives you a fresh start with the new grouping strategy.

To confirm the regrouping, click the `Regroup` button. Regrouping will typically not take very long to complete, a few seconds to a minute depending on the size of the collection.

## Troubleshooting

<AccordionGroup>
  <Accordion title="A person I know is in the footage does not show up in the People tab">
    This could be because the person got grouped with another person. Regroup the collection at a stricter level (**<Icon icon="ellipsis-vertical" /> -> Regroup**, then **Very Strict** or **Ultra Strict**) to improve the accuracy of the grouping.
  </Accordion>

  <Accordion title="There's a group with a lot of different people in it">
    Regroup the collection at a stricter level (**<Icon icon="ellipsis-vertical" /> -> Regroup**, then **Very Strict** or **Ultra Strict**) to separate people who look alike.
  </Accordion>
</AccordionGroup>
