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.
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 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.
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.
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
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TruU Docs","colors":{"primary":"#101010","light":"#faa536","dark":"#faa536"},"logo":{"light":"https://mintcdn.com/truu-2/xOFqKpyg8HX9MjRC/images/Frame2147229932.png?fit=max\u0026auto=format\u0026n=xOFqKpyg8HX9MjRC\u0026q=85\u0026s=b66a2d4ee7312a3bd29780ed69412b2a","dark":"https://mintcdn.com/truu-2/xOFqKpyg8HX9MjRC/images/Frame2147229931.png?fit=max\u0026auto=format\u0026n=xOFqKpyg8HX9MjRC\u0026q=85\u0026s=0bfe1c1c8b293387d07ea4145aa57b74"},"favicon":"https://mintcdn.com/truu-2/29VTyTZfF-4PId_r/d332cdf-learn-more.svg?fit=max\u0026auto=format\u0026n=29VTyTZfF-4PId_r\u0026q=85\u0026s=24c4a71a0ed524868233103635f73373","appearance":{"default":"dark"},"navbar":{"links":[{"href":"https://www.truu.ai/","label":"TruU Website"},{"href":"https://www.truu.ai/contact","label":"Support"}]},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/truu-security","website":"https://www.truu.ai/"}},"fonts":{"family":"Inter"},"interaction":{"drilldown":true},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"truu-2","hasAudioNarration":false,"actualSubdomain":"truu-2","customDomains":["docs.truu.ai"],"gitSource":{"type":"github","owner":"truudocs","repo":"mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b008a37dfdc371b948ae3fc","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Passwordless","count":302},{"language":"default","tag":"Setup","count":132},{"language":"default","tag":"Release Notes","count":93},{"language":"default","tag":"User Guides","count":74},{"language":"default","tag":"Platform","count":70},{"language":"default","tag":"TOTAL","count":69},{"language":"default","tag":"Identity Verification","count":63},{"language":"default","tag":"Guides","count":52},{"language":"default","tag":"FAQ","count":40},{"language":"default","tag":"FAQ: Knowledge Base","count":40}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"sa@truu.ai","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"idv/factors/face","slug":"/idv/factors/face","pageMetadata":{"title":"Face","description":"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.","icon":"face-viewfinder","href":"/idv/factors/face"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"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.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Frame,Heading,OptimizedImage,Table,Tip}=_components;if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`before-you-start`,children:`Before you start`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`At least one source of reference photos (see below). Face can’t run for an employee with no photo from any source.`}),`\n`,_jsxs(_components.li,{children:[`Employees have a phone camera. Laptop webcams often fail; turn on `,_jsx(_components.strong,{children:`Phone camera only`}),` to send desktop users to their phone.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`settings`,children:`Settings`}),`\n`,_jsxs(_components.p,{children:[`Open `,_jsx(_components.strong,{children:`Factors → Face`}),`.`]}),`\n`,_jsxs(Frame,{children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,style:{maxWidth:`440px`,margin:`0 auto`},alt:`Face settings panel with reference photo sources Proofing photo and Directory photo, Phone camera only, Matching and Attempts per run`,src:`https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-light.png?fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=df3a581ad9270b5024f55265452f1598`,\"data-og-width\":`976`,width:`976`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/idv/factor-face-light.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-light.png?w=280\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=59243b735c576d2003f2c94f767943c5 280w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-light.png?w=560\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=0597ac2987289a6771ff190ad4a52823 560w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-light.png?w=840\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=e810e45407b11652200ff8fb20000f8d 840w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-light.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=e841f89c7152db209c4c53f0b035dbcd 1100w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-light.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=fa900a0c74bba5b674f2232e28f61d35 1650w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-light.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=eba09217d74a66c26255cc3344a04726 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,style:{maxWidth:`440px`,margin:`0 auto`},alt:`Face settings panel with reference photo sources Proofing photo and Directory photo, Phone camera only, Matching and Attempts per run`,src:`https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-dark.png?fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=410699934e822114e74e41fb933093c4`,\"data-og-width\":`976`,width:`976`,\"data-og-height\":`1800`,height:`1800`,\"data-path\":`images/idv/factor-face-dark.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-dark.png?w=280\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=aab13ccc6b25760cc5b773c49b92c8cb 280w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-dark.png?w=560\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=4d91fb794c9ee5b266959d308ba48f9d 560w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-dark.png?w=840\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=eccf54c037779073da6f96ec1ade0760 840w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-dark.png?w=1100\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=624f9ab9b30a293d66b0c3e5dd517077 1100w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-dark.png?w=1650\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=9d7ece89ec2741debb9e213fc7cb3d21 1650w, https://mintcdn.com/truu-2/ggexkQvmOZdl3yHs/images/idv/factor-face-dark.png?w=2500\u0026fit=max\u0026auto=format\u0026n=ggexkQvmOZdl3yHs\u0026q=85\u0026s=4bce3d2bcef4a4bc12230cacd860c6ae 2500w`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Setting`}),_jsx(_components.th,{children:`What it does`}),_jsx(_components.th,{children:`Default`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Where reference photos come from`})}),_jsx(_components.td,{children:`Photo sources tried in order until one has a photo for the employee. Drag to reorder.`}),_jsx(_components.td,{children:`Proofing photo, then Directory photo`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Phone camera only`})}),_jsx(_components.td,{children:`Desktop users scan a QR code and finish on their phone; the computer’s camera isn’t offered`}),_jsx(_components.td,{children:`Off`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Matching`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Standard`}),` (fewer false rejections), `,_jsx(_components.strong,{children:`High`}),` (balanced accuracy) or `,_jsx(_components.strong,{children:`Very high`}),` (strictest matching)`]}),_jsx(_components.td,{children:`High`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Attempts per run`})}),_jsx(_components.td,{children:`Failed matches allowed before the factor fails`}),_jsx(_components.td,{children:`3 tries`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Advanced → Fallback extensions`})}),_jsx(_components.td,{children:`For photos in your own storage: file extensions to try, in order, when the path has no extension or the file is missing`}),_jsx(_components.td,{children:`None`})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`reference-photo-sources`,children:`Reference photo sources`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Source`}),_jsx(_components.th,{children:`What it is`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Proofing photo`})}),_jsxs(_components.td,{children:[`The selfie from the employee’s last passed `,_jsx(_components.a,{href:`/idv/factors/proofing/overview`,children:`Proofing`}),` check, stored when `,_jsx(_components.strong,{children:`Proofing photo`}),` is on under Proofing’s `,_jsx(_components.strong,{children:`What is stored`})]}),_jsx(_components.td,{children:`The most reliable source. A re-proof replaces it.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Directory photo`})}),_jsxs(_components.td,{children:[`The profile photo in your directory (`,_jsx(_components.code,{children:`thumbnailPhoto`}),` in Entra ID)`]}),_jsx(_components.td,{children:`Often old or tiny (about 96 pixels) and matches less reliably`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`Your own storage`})}),_jsxs(_components.td,{children:[`Photos in your Amazon S3 bucket or Azure Blob container, found with a path template such as `,_jsx(_components.code,{children:`photos/{upn}.jpg`}),` (placeholders: `,_jsx(_components.code,{children:`{upn}`}),`, `,_jsx(_components.code,{children:`{object_id}`}),`, `,_jsx(_components.code,{children:`{tenant_id}`}),`, or any directory attribute such as `,_jsx(_components.code,{children:`{employee_id}`}),`)`]}),_jsxs(_components.td,{children:[`Choose `,_jsx(_components.strong,{children:`Add a photo source`}),`, then pick or add a store. If the photos are encrypted, turn on decryption in `,_jsx(_components.strong,{children:`Settings → Storage`}),`. See `,_jsx(_components.a,{href:`/idv/connect/storage`,children:`Storage`}),`.`]})]})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Put Proofing photo first. A new hire with no photo verifies once with Proofing, and every later Face check matches against that verified selfie.`})}),`\n`,_jsx(Heading,{level:`2`,id:`what-the-employee-sees`,children:`What the employee sees`}),`\n`,_jsxs(_components.p,{children:[`The employee takes a selfie following on-screen guidance. On a computer with `,_jsx(_components.strong,{children:`Phone camera only`}),` on, they scan a QR code and take the selfie on their phone while the computer waits. See `,_jsx(_components.a,{href:`/idv/end-users/what-to-expect`,children:`What to expect`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Symptom`}),_jsx(_components.th,{children:`Cause`}),_jsx(_components.th,{children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Face isn’t offered to new hires`}),_jsx(_components.td,{children:`No reference photo from any source`}),_jsx(_components.td,{children:`Keep a Proofing column in the flow; with Proofing photo on, their first proofing creates one`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Matches fail for long-tenured employees`}),_jsx(_components.td,{children:`The directory photo is old or very small`}),_jsx(_components.td,{children:`Put Proofing photo first, or refresh directory photos`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The webcam never starts or loops on “move closer”`}),_jsx(_components.td,{children:`Laptop webcam quality or permissions`}),_jsxs(_components.td,{children:[`Turn on `,_jsx(_components.strong,{children:`Phone camera only`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Photos in your bucket aren’t found`}),_jsx(_components.td,{children:`The path template doesn’t match the object names`}),_jsxs(_components.td,{children:[`Check the template and `,_jsx(_components.strong,{children:`Fallback extensions`}),`; run `,_jsx(_components.strong,{children:`Test connection`}),` on the store`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`related`,children:`Related`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/idv/factors/proofing/overview`,children:`Proofing`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/idv/connect/storage`,children:`Storage`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/idv/security/data-handling`,children:`Data handling`})}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Face","description":"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.","icon":"face-viewfinder","href":"/idv/factors/face"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Before you start","slug":"before-you-start","depth":2,"children":[]},{"title":"Settings","slug":"settings","depth":2,"children":[]},{"title":"Reference photo sources","slug":"reference-photo-sources","depth":2,"children":[]},{"title":"What the employee sees","slug":"what-the-employee-sees","depth":2,"children":[]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]},{"title":"Related","slug":"related","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-block {\n display: block\n}\n.mint-hidden {\n display: none\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"truu-2","siteName":"TruU Docs","title":"Face - TruU Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-08T17:46:23.344Z","originalFileLocation":"idv/factors/face.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"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.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TruU Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Face - TruU Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"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.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TruU Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truu.ai/idv/factors/face\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://truu-2.mintlify.site/_mintlify/api/og/v2?division=Factors\u0026amp;title=Face\u0026amp;description=Match+a+live+selfie%2C+with+a+liveness+check%2C+against+a+trusted+reference+photo%3A+the+photo+kept+from+a+passed+proofing+check%2C+your+directory+photo%2C+or+photos+in+y\u0026amp;theme=0d751508c8c1a0d592616b7c\u0026amp;signature=df254d88060c532a5115a1fe427df0b629d0455834bdf73298435fe8bcd9bd03\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Face - TruU Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"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.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://truu-2.mintlify.site/_mintlify/api/og/v2?division=Factors\u0026amp;title=Face\u0026amp;description=Match+a+live+selfie%2C+with+a+liveness+check%2C+against+a+trusted+reference+photo%3A+the+photo+kept+from+a+passed+proofing+check%2C+your+directory+photo%2C+or+photos+in+y\u0026amp;theme=0d751508c8c1a0d592616b7c\u0026amp;signature=df254d88060c532a5115a1fe427df0b629d0455834bdf73298435fe8bcd9bd03\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/truu-2/rRGus2v3_vJHJYq0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TruU Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#101010\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truu.ai/idv/factors/face\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/idv/factors/face.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truu.ai/#organization\",\"name\":\"TruU Docs\",\"url\":\"https://docs.truu.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/truu-2/xOFqKpyg8HX9MjRC/images/Frame2147229932.png?fit=max\u0026auto=format\u0026n=xOFqKpyg8HX9MjRC\u0026q=85\u0026s=b66a2d4ee7312a3bd29780ed69412b2a\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truu.ai#website\",\"name\":\"TruU Docs\",\"url\":\"https://docs.truu.ai\",\"publisher\":{\"@id\":\"https://docs.truu.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truu.ai/idv/factors/face#webpage\",\"url\":\"https://docs.truu.ai/idv/factors/face\",\"name\":\"Face\",\"description\":\"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.\",\"dateModified\":\"2026-10-08T17:46:23.344Z\",\"isPartOf\":{\"@id\":\"https://docs.truu.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truu.ai/idv/factors/face#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truu.ai/idv/factors/face#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Factors\",\"item\":\"https://docs.truu.ai/idv/factors/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Face\",\"item\":\"https://docs.truu.ai/idv/factors/face\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.truu.ai/idv/factors/face#article\",\"headline\":\"Face\",\"name\":\"Face\",\"description\":\"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.\",\"url\":\"https://docs.truu.ai/idv/factors/face\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truu.ai/idv/factors/face#webpage\"},\"dateModified\":\"2026-10-08T17:46:23.344Z\",\"publisher\":{\"@id\":\"https://docs.truu.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truu.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TruU Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"TruU Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/idv/factors/face.md","siteName":"TruU Docs","nav":{"global":null,"products":[{"product":"Passwordless","color":{"light":"#c86c0e","dark":"#c86c0e"},"pages":[{"title":"Passwordless","href":"/docs/welcome-to-truu"}]},{"product":"TOTAL","color":{"light":"#c6c6c6","dark":"#c6c6c6"},"pages":[{"title":"TOTAL","href":"/quickstart"}]},{"product":"Identity Verification","tabs":[{"tab":"Guides","groups":[{"group":"Get started","pages":[{"title":"Welcome to TruU IDV","icon":"hand-wave","href":"/idv/introduction"},{"title":"Quickstart","icon":"rocket","href":"/idv/getting-started/quickstart"},{"title":"Go live","icon":"flag-checkered","href":"/idv/getting-started/go-live"}]},{"group":"Use cases","pages":[{"title":"How use cases work","icon":"route","href":"/idv/use-cases/overview"},{"title":"Help desk verification","icon":"headset","href":"/idv/use-cases/help-desk"},{"title":"Self-service credential reset","icon":"key","href":"/idv/use-cases/credential-reset"},{"title":"Verified device enrollment","icon":"laptop","href":"/idv/use-cases/device-enrollment"},{"title":"Shared devices","icon":"users-viewfinder","href":"/idv/use-cases/shared-devices"}]},{"group":"Factors","pages":[{"title":"How factors work","description":"A factor is a method of proving identity. What each factor proves, what it needs from your directory, how strong it is, and when it is offered.","icon":"fingerprint","href":"/idv/factors/overview"},{"title":"Face","icon":"face-viewfinder","href":"/idv/factors/face"},{"group":"Proofing","expanded":true,"pages":[{"title":"Proofing","description":"How document and selfie proofing runs in TruU IDV: the integrated provider, bring-your-own Entrust, Persona, or PingOne Verify for production, what TruU sends the vendor, what comes back, the decision record, name and DOB matching, document allowlists, and face extraction.","icon":"id-card","href":"/idv/factors/proofing/overview"},{"title":"Didit","icon":"passport","href":"/idv/factors/proofing/didit"},{"title":"PingOne Verify","icon":"circle-check","href":"/idv/factors/proofing/pingone-verify"},{"title":"Persona","icon":"address-card","href":"/idv/factors/proofing/persona"},{"title":"Entrust (Onfido)","icon":"shield-check","href":"/idv/factors/proofing/entrust"}]},{"title":"SMS","icon":"message-sms","href":"/idv/factors/sms"},{"title":"Email","icon":"envelope","href":"/idv/factors/email"},{"title":"Knowledge","icon":"brain","href":"/idv/factors/knowledge"},{"title":"Badge","icon":"id-badge","href":"/idv/factors/badge"}]},{"group":"Build","pages":[{"title":"Flows and templates","icon":"diagram-project","href":"/idv/build/flows"},{"title":"Verification requests and links","icon":"link","href":"/idv/build/verification-requests"},{"title":"Branding","icon":"palette","href":"/idv/build/branding"}]},{"group":"Connect","pages":[{"title":"How integrations fit together","icon":"plug","href":"/idv/connect/overview"},{"group":"Directory","expanded":true,"pages":[{"title":"Connect your directory","icon":"building","href":"/idv/connect/directory/overview"},{"title":"Connect Microsoft Entra ID","icon":"microsoft","href":"/idv/connect/directory/entra-id"},{"title":"Connect Okta","icon":"circle-nodes","href":"/idv/connect/directory/okta"}]},{"group":"HR system","expanded":true,"pages":[{"title":"Connect your HR system","icon":"id-card","href":"/idv/connect/hr/overview"},{"title":"Connect BambooHR","icon":"id-card","href":"/idv/connect/hr/bamboohr"},{"title":"Connect Workday","icon":"id-card","href":"/idv/connect/hr/workday"},{"title":"Connect UKG Pro","icon":"id-card","href":"/idv/connect/hr/ukg-pro"}]},{"title":"Storage","icon":"database","href":"/idv/connect/storage"}]},{"group":"Connectors","pages":[{"title":"ServiceNow","icon":"ticket","href":"/idv/connect/servicenow"},{"title":"Microsoft Teams","icon":"comments","href":"/idv/connect/microsoft-teams"},{"title":"TruU Passwordless","icon":"fingerprint","href":"/idv/connect/passwordless"},{"title":"Windows TAP","icon":"key","href":"/idv/connect/windows-tap"},{"title":"PingOne MFA","icon":"rotate","href":"/idv/connect/pingone-mfa"}]},{"group":"Administer","pages":[{"title":"Console tour","icon":"map","href":"/idv/admin/console-tour"},{"title":"Sign-in, SSO and passkeys","icon":"right-to-bracket","href":"/idv/admin/sign-in"},{"title":"Team and roles","icon":"users","href":"/idv/admin/team-and-roles"},{"title":"Activity and export","icon":"list-check","href":"/idv/admin/activity"},{"title":"Insights","icon":"chart-line","href":"/idv/admin/insights"},{"title":"Credential health","icon":"heart-pulse","href":"/idv/admin/credential-health"}]},{"group":"For help desk agents","pages":[{"title":"Agent guide","icon":"headset","href":"/idv/help-desk/agent-guide"}]},{"group":"For employees","pages":[{"title":"What to expect during verification","icon":"user-check","href":"/idv/end-users/what-to-expect"},{"title":"Your privacy and your data","icon":"shield-halved","href":"/idv/end-users/your-privacy"}]},{"group":"Resources","pages":[{"title":"Troubleshooting","icon":"wrench","href":"/idv/resources/troubleshooting"},{"title":"Frequently asked questions","icon":"circle-question","href":"/idv/resources/faq"},{"title":"Glossary","icon":"book","href":"/idv/resources/glossary"},{"title":"Release notes","icon":"sparkles","href":"/idv/resources/release-notes"},{"title":"Status labels","icon":"tag","href":"/idv/resources/status-labels"},{"title":"Support","icon":"life-ring","href":"/idv/resources/support"},{"title":"SMS verification messages","href":"/idv/resources/sms-opt-in"}]}]},{"tab":"Security \u0026 compliance","pages":[{"title":"Security \u0026 compliance","href":"/idv/security/overview"}]},{"tab":"API","pages":[{"title":"API","href":"/idv/api/quickstart"}]}]}]},"basePath":"","title":"Face - TruU Docs","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-D0FT0qQs.js","DynamicMarkdown-CQM9Bhbv.js","zoom-image-lightbox-BQ4tbj_9.js","lightbox-handle-r17bVUz3.js"]}