People and pets
Pets: give your cat or dog their own profile Watch on YouTube
Frameleaf finds faces in your photos and videos and groups them by person, right on your own server. Give someone a name once and you can search for them, browse every photo they’re in, and combine them with other filters.
Open People from the sidebar to see everyone. Click a person to see their photos. Choose who appears, beside Show hidden, lets you hide people you don’t want on the page. A photo’s info panel also shows who’s in it.
- Runs on your server. Face detection runs on your server or a computer at home, unless your administrator chooses Frameleaf Cloud for it. Grouping faces into people and naming them always happen on your server. See Search and faces on Frameleaf Cloud.
- Merge and fix. Merge two or more groups that are the same person, or move a face that landed in the wrong group.
- Tag by hand. Draw a box around a face the model missed and assign it to someone.
Name people
Section titled “Name people”Click a face on the People page, or a person in a photo’s info panel, and type their name. Name the people you photograph most first: the People page lists the biggest groups first, and every name you add makes search, memories and AI descriptions more useful.
You don’t need to name everyone. Strangers in the background are fine left unnamed.
On a person’s page
Section titled “On a person’s page”- Featured photo changes the photo shown for them.
- Hide hides their face from the Explore page and the photo viewer.
- Set date of birth shows their age at the time each photo was taken, and brings up their birthday in Memories. Once it’s set, the button reads Date of birth.
- Merge people combines them with another group.
- Favorite pins them to the top of the list.
- Fix incorrect match and Correction history are for putting faces right; see Fix mistakes.
- Recognition groups opens People & sharing in your account settings, where you can Share face recognition with family: people you add see the same named faces you do, without seeing your photos.
Archived photos in People
Section titled “Archived photos in People”Archived photos are left out of People unless you choose otherwise. To include them, open Settings, then Your preferences, then Tools & sidebar, open People options under the People row and turn on Include archived photos, then save.
With it on, archived photos show on person pages and count in People: in each person’s photo count, the People total, name search and the Show a person once they appear in threshold. Turn it off to keep People to the photos on your timeline.
- It’s your own view. The choice affects only what you see, including people in a partner’s library or a shared album. Everyone else on the server keeps their own setting.
- Nothing moves. Archived photos stay archived and out of your timeline, and faces in them are still found as before.
- Locked stays locked. Locked photos are never included, whatever this setting says.
Find someone
Section titled “Find someone”- Type their name in search, or use
person:in the search box:person:Jamie beach. - Ask in plain words:
photos of Jamie and Sam last summer. - In the filter panel’s People section, choose several people and whether results include All of them, Any of them, or Exclude them.
See Search syntax for the details.
Fix mistakes
Section titled “Fix mistakes”- Is this all one person? When the faces under one name look like two different people, the People page asks, for example Is this all Sam? “12 of the 80 photos under Sam look like someone else”, with faces from both sides. No, split them moves those faces to a new, unnamed person; Yes, all Sam keeps them together, which helps when someone has grown up a lot; Ask me later is under More answers. Each answer can be undone. These questions come after the nightly tidy-up.
- Merge suggestions. When two groups look like the same person, Frameleaf asks. Answer Yes, merge, No, Ask me later or Stop suggesting for that person. Each answer can be undone.
- Fix incorrect match. Opens a list of the faces grouped as that person. On any face that belongs to someone else, choose Not this person, then pick a suggested person, Someone else…, Someone new… or Not a face of anyone. Select several faces to move them together.
- Correction history, in a person’s menu, lists every change you made to that person’s faces, most recent first: faces moved, taken off or merged. Choose Undo beside a change to reverse it. A change can’t be undone once the face has changed again, or its photo or person is gone, and the list says why.
- Add a face by hand. Open the photo’s info panel, then under People choose Add, draw a box around the face and assign it. You can also move and resize faces Frameleaf found.
Corrections stick when faces are detected or recognised again. Fixing a name also marks the AI descriptions that used the old name as out of date, so they’re redone.
Cats and dogs get their own named profiles, separate from people. Open Pets under Explore to see them, and a pet’s page to see every photo of them. If you don’t keep pets, you can take Pets out of the sidebar under Tools & sidebar in your preferences. Pets also appear in Memories, and you can find them in search: the filter panel has a Pets section once you have a pet, and Ask understands photos of Rex.
You don’t need any AI to use pets: open a photo, drag a box across the animal (or mark the whole photo) and choose the pet. Pet recognition is optional: Look for pets suggests photos, and every suggestion waits for your confirmation. Your administrator has to install the recognition model first, and it works on still photos only.
How grouping works
Section titled “How grouping works”Recognition runs as a background job after upload. On a large library the first pass can take a while; you can watch it on the Activity page, under Faces & identity.
Before anyone is found
Section titled “Before anyone is found”Until the first people are found, the People page says what’s happening instead of looking empty:
| You see | It means |
|---|---|
| Face recognition is turned off | Face recognition is off on your server. An administrator sees Turn it on, which opens its settings; everyone else is told it’s up to the person who runs the server |
| Looking for the people in your photos | Recognition is working through your photos. A large library can take a day |
| Face recognition is paused | Background work is paused. It carries on when it’s resumed, from Background work settings |
| Face recognition is saved for the night | It’s held for the overnight schedule |
| Face recognition has not started yet | It’s waiting to start |
| No people found yet | What everyone but an administrator sees while photos are still waiting: “Some photos have not been looked through for faces yet. People appear here as they are found.” |
| No people yet | Recognition is on and has looked, but found nobody yet |
While photos are still waiting, the page checks again every 30 seconds, so people appear without a reload.
A new person is only created once Frameleaf finds a few similar faces (three by default). A face with too few matches waits until others are processed, and if it still matches nobody it’s treated as a stranger in the background. People with fewer faces than this threshold are hidden from the list.
For videos, faces come from the video’s thumbnail only.
For the details, the settings and a step-by-step guide to better groups, see How face recognition works.
Privacy
Section titled “Privacy”- Named people also help AI descriptions name who’s in a photo. Only names you’ve given are ever used.
- People who appear only in Locked photos stay hidden until you unlock. Their counts only include photos you can see, and their thumbnail is never taken from a Locked photo.
- In a shared space, the names you give people are only shown to you.
For administrators
Section titled “For administrators”Recognition settings are in Settings, then Search & intelligence, then Faces & identity. How carefully to group offers Fewer mistakes, Balanced and Group more photos, and sets the three numbers under Advanced: face model and numbers. Small changes work best:
- Face clarity needed (default 0.7): stay at 0.5 or above to avoid false faces. Very high values like 0.9 miss real ones.
- How alike two faces must be (default 0.5): lower it if you have twins or very similar-looking people. Stay between 0.3 and 0.7.
- Photos needed before someone appears (default 3): how many similar faces it takes to create a person.
See How face recognition works for every setting, the recognition jobs and a step-by-step guide to better groups.
© 2026 Frameleaf Inc. All rights reserved.
Frameleaf and the Frameleaf logo are Trademarks of Frameleaf Inc.




