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

# Face

> Match a live selfie, with a liveness check, against a trusted reference photo: the photo kept from a passed proofing check, your directory photo, or photos in your own storage.

Face matches a live selfie against a trusted reference photo, with a liveness check so a printed photo or screen can't pass. It's strong and fast for anyone with a reference photo on file.

## Before you start

* At least one source of reference photos (see below). Face can't run for an employee with no photo from any source.
* Employees have a phone camera. Laptop webcams often fail; turn on **Phone camera only** to send desktop users to their phone.

## Settings

Open **Factors → Face**.

![Face settings panel with reference photo sources Proofing photo and Directory photo, Phone camera only, Matching and Attempts per run](https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-light.png?fit=max\&auto=format\&n=ggexkQvmOZdl3yHs\&q=85\&s=df3a581ad9270b5024f55265452f1598)

| Setting | What it does | Default |
| - | - | - |
| **Where reference photos come from** | Photo sources tried in order until one has a photo for the employee. Drag to reorder. | Proofing photo, then Directory photo |
| **Phone camera only** | Desktop users scan a QR code and finish on their phone; the computer's camera isn't offered | Off |
| **Matching** | **Standard** (fewer false rejections), **High** (balanced accuracy) or **Very high** (strictest matching) | High |
| **Attempts per run** | Failed matches allowed before the factor fails | 3 tries |
| **Advanced → Fallback extensions** | For photos in your own storage: file extensions to try, in order, when the path has no extension or the file is missing | None |

## Reference photo sources

| Source | What it is | Notes |
| - | - | - |
| **Proofing photo** | The selfie from the employee's last passed [Proofing](https://docs.truu.ai/idv/factors/proofing/overview.md) check, stored when **Proofing photo** is on under Proofing's **What is stored** | The most reliable source. A re-proof replaces it. |
| **Directory photo** | The profile photo in your directory (`thumbnailPhoto` in Entra ID) | Often old or tiny (about 96 pixels) and matches less reliably |
| **Your own storage** | Photos in your Amazon S3 bucket or Azure Blob container, found with a path template such as `photos/{upn}.jpg` (placeholders: `{upn}`, `{object_id}`, `{tenant_id}`, or any directory attribute such as `{employee_id}`) | Choose **Add a photo source**, then pick or add a store. If the photos are encrypted, turn on decryption in **Settings → Storage**. See [Storage](https://docs.truu.ai/idv/connect/storage.md). |

> [!TIP]
>
> Put Proofing photo first. A new hire with no photo verifies once with Proofing, and every later Face check matches against that verified selfie.

## What the employee sees

The employee takes a selfie following on-screen guidance. On a computer with **Phone camera only** on, they scan a QR code and take the selfie on their phone while the computer waits. See [What to expect](https://docs.truu.ai/idv/end-users/what-to-expect.md).

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| Face isn't offered to new hires | No reference photo from any source | Keep a Proofing column in the flow; with Proofing photo on, their first proofing creates one |
| Matches fail for long-tenured employees | The directory photo is old or very small | Put Proofing photo first, or refresh directory photos |
| The webcam never starts or loops on "move closer" | Laptop webcam quality or permissions | Turn on **Phone camera only** |
| Photos in your bucket aren't found | The path template doesn't match the object names | Check the template and **Fallback extensions**; run **Test connection** on the store |

## Related

* [Proofing](https://docs.truu.ai/idv/factors/proofing/overview.md)
* [Storage](https://docs.truu.ai/idv/connect/storage.md)
* [Data handling](https://docs.truu.ai/idv/security/data-handling.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.