Media library
Face recognition
How People Recognition detects faces, links them to your library, and where you see results in Media and uploads.
Use this article to understand how People Recognition works in Clipido, where detected faces appear, and what happens automatically after you upload images.
People Recognition is an add-on. Clipido must enable it on your plan before you can use face detection. After that, a club admin must turn it on under Settings → People Recognition. Only club admins can manage the people library.
What People Recognition does after you upload an image
When People Recognition is active, Clipido detects faces in uploaded images and stores a face embedding for each detection. Face detection does not run on videos or documents. If you open a non-image file in Media, the People panel shows "Not available" with the message "Face detection and recognition is only available for images."
After detection finishes for an upload batch, Clipido can automatically link new faces in that batch to people who are already in your people library. Clipido does not create new people automatically. An admin must name unknown faces manually.
When you first enable People Recognition, Clipido also creates a People tagging form so you can tag people with metadata fields, the same way you tag files.
Where detected faces appear in Clipido
Face recognition results show up in three places.
The table below lists where to open face recognition results and what each view contains.
| Where | How to open it | What you see |
|---|---|---|
| Media preview | Open an image in Media, then the People side panel | Library and Unknown people sections |
| Upload timeline | Open the upload side panel, then the Face detection step | Library and Unknown people sections |
| Settings people library | Settings → People Recognition | People card listing everyone in your library |
In Media preview, the People panel has two sections. Library uses the subtitle "People already added to the library". Unknown people uses "Detected faces that haven't been identified yet".
On the upload timeline, the Face detection step opens a detail view titled Face recognition. When processing completes, the timeline may show "Face recognition is ready, for your latest upload." On failure, it shows "Face recognition failed, for your latest upload."
In Settings, the People card lists "All the people in your library." Click a person to open Edit person and manage their name, tags, and related actions.
How automatic matching links faces to existing people
After every file in an upload batch has finished face processing, Clipido compares detected faces against people already in your library.
Clipido links a face to an existing person when the face is similar enough to that person's profile. After a link, Clipido searches your workspace for more photos of the same person. While that search runs, the person card can show "Detecting person..." When matching finishes, it shows how many times the person was detected, for example "Detected 3 times across all assets".
Automatic matching only applies to people you have already added. Unknown faces stay under Unknown people until an admin names them.
Searching Media by recognized people
With People Recognition active, you can filter Media search by person name under People → Name. People filters do not appear when the add-on is off or the admin toggle is off.
From a recognized face in Media preview, click Search person to open Media filtered to that person.