> ## 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.

# Face detection

> Detect and identify people in your footage

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

## Overview

Face detection allows Jumper to automatically identify people appearing in your footage. Once detected, you can search for specific individuals and quickly find all scenes where they appear.

## How it works

Face detection works by analyzing your media files to identify and group similar faces together.

<Steps>
  <Step title="Mark media for analysis">
    In the <a href="/interface/media-tab">Media tab</a>, mark which files should be analyzed for face detection.
  </Step>

  <Step title="Choose a Collection">
    Select which <Tooltip tip="Collections are containers that isolate people from different projects or productions, keeping your identified people organized and context-specific.">Collection</Tooltip> to add the detected faces to.
  </Step>

  <Step title="Analysis">
    Jumper processes the media and groups similar faces together.
  </Step>

  <Step title="Name people">
    Assign names to the detected people in the <a href="/interface/people-tab">People tab</a>.
  </Step>

  <Step title="Search for people">
    Once named, you can search for people using the <code>@</code> syntax in the <a href="/interface/search-tab">Search tab</a>, like <code>@John sitting on a bench</code>. Select multiple people and use the <strong>AND/OR</strong> control to find shots where they appear together (<strong>AND</strong>) or where any of them appear (<strong>OR</strong>).
  </Step>
</Steps>

<Card horizontal title="Detailed guide to using face detection" arrow="true" href="/guides/face-detection">
  Step-by-step guide to using face detection
</Card>

## Collections

When you analyze media with face detection, the identified faces are added to a **Collection**. Collections are containers that isolate people from different projects or productions, keeping your identified people organized and context-specific.

**Why Collections?**

Collections prevent people from different productions from mixing together. For example:

* If you're working on a TV show, you can create a collection for that show's cast
* When you start a new production, create a separate collection for those people

**How Collections work:**

* Each collection is independent. People identified in one collection don't appear in others
* You can create multiple collections for different projects, shows, or any organizational structure that makes sense for your workflow
* When analyzing media, you choose which collection to add the detected faces to
* When new media is analyzed to an existing collection, Jumper will try to match the faces to the existing named people in the collection. If a match is found, the face is added to the existing person. If no match is found, a new unnamed person is created.

You can view and manage all your collections in the [People tab](/interface/people-tab)

## Thresholds

Jumper's face detection algorithm extracts faces from the media files and then groups them together based on similarity.

* The algorithm will try to exclude low res or blurry faces
* The algorithm may create multiple groups for the same person if the confidence is low

## Merging and regrouping

Sometimes the face detection algorithm may create separate groups for the same person, or group different people together. This can happen when:

* Lighting conditions vary significantly
* People appear at different angles or distances
* The algorithm has low confidence in its detection

You can manually merge groups that represent the same person, or regroup the entire collection with different parameters to improve accuracy. When regrouping, you can choose to preserve existing names or remove them all for a fresh start.

<Card horizontal title="Merging and regrouping" arrow="true" href="/guides/face-detection#merging-groups">
  Read more about Merging and Regrouping
</Card>

## Known Issues

* When searching for a person, the selection in the Context Picker is ignored. This is being worked on and will be fixed in a future update.
