# Facial Recognition The People feature uses AI to detect and recognize faces across the images and videos in your drive. Once individuals are tagged, you can quickly find every asset a person appears in, and even combine their name with other search terms to find exactly the moment you're looking for. ### How It Works When assets are uploaded to a drive, any images or videos in AI-indexed folders are automatically scanned for faces. Unidentified faces (those not yet linked to a named profile) are surfaced within the asset itself, in the **Details** tab under the **Unidentified Faces** section. From there you can create a profile using that face as a starting point. The **People** view in the left sidebar only displays individuals who have already been given a named profile. It is not a list of all detected faces, instead it is a directory of tagged people. Facial recognition are scoped per drive. Faces indexed in one drive are not visible or searchable from another.
### Creating a Profile There are two ways to create a profile for an individual: **From an asset:** Open any asset containing an unidentified face, go to the **Details** tab, and find the face under **Unidentified Faces**. You can create a profile directly from there, with that face automatically used as a sample. **From the People view:** Click **+ Add Individual** in the top right, then enter a name and manually select sample images. Whichever path you take, you'll want to provide good sample images: 1. Enter a name for the individual. 2. Select one or more sample images to help the system learn what this person looks like. **Tips for best results:** * Use at least one dedicated photo where the person's face is clearly visible, unobstructed, and well-lit. * Adding 2–3 additional sample photos meaningfully improves recognition accuracy, especially across varying angles, lighting conditions, or time periods. * Avoid samples where the face is partially hidden, in shadow, or very small in the frame. Once the profile is saved, the system will scan your drive's assets and surface every instance where that individual appears. ### Searching by Person Tagged individuals are fully integrated into the drive's AI search. You can search by name alone, or combine a name with other descriptive terms to narrow results further. For example, searching **"JJ throwing a football"** will return images and videos of JJ specifically performing that action, not just any asset containing JJ, and not just any asset of someone throwing a football. This makes it easy to find specific moments involving specific people without having to browse manually. ### Things to Keep in Mind * Only assets in AI-indexed folders are scanned. If a folder is excluded from AI indexing, faces in those assets will not appear in the People view. * Newly uploaded assets may not be reflected immediately, as indexing runs after upload. * Recognition accuracy improves with more and better-quality sample images. If results seem incomplete, try adding additional samples to the individual's profile. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://academy.shade.inc/ai-tools/facial-recognition.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.