People commands
Scan the people Immich knows, confirm their roles, and reuse them in films. The browser's People page edits the same registry. People and home is the simplest setup path.
In Docker, run these commands from the installation folder with
docker compose exec immich-memories before immich-memories.
Scan and inspect
immich-memories people scan
immich-memories people show
The scan reads counts and dates, not pictures. It updates its suggestions without overwriting your confirmed roles and relationships. A rescan keeps your saved groups too.
A named person needs enough pictures to count. The floor is a tenth of the most-pictured named person's count, never under 5 and never over 25:
| Most-pictured person | Floor |
|---|---|
| 18 pictures | 5 |
| 120 pictures | 12 |
| 250 pictures or more | 25 |
So a small library keeps its handful of regulars, and a face caught twice in the background stays out. Once anybody is on 250 pictures the floor is 25, which is where most libraries land. The scan prints the floor it used. Rescan the library on the People page uses the same rule. Set it by hand with --min-assets:
immich-memories people scan --min-assets 10
A person you confirmed stays in the registry whatever their count.
Say whose library it is
The scan guesses the owner: the name you passed with --owner, else the Immich account's own name, else whoever has the longest span of pictures. Say it once and no scan changes it:
immich-memories people owner "Alex Example"
immich-memories people owner --nobody
immich-memories people owner --account partner "Sam Sample"
immich-memories people owner
--nobody is for a shared family account where nobody in the library owns it. Without a person the command prints the current answer and how it was found. Changing the owner clears the roles the registry filled in from the old one and works them out again from the new one. Roles you typed stay. --owner on people scan still works as the guess for a library nobody has answered for.
Export and edit
The live registry is in the store. Export it before editing YAML:
immich-memories people export --to people.yaml
Edit the export, then deliberately replace the registry with that file:
immich-memories people import --from people.yaml --replace
Import validates the whole file first. --replace can replace newer answers, so use a fresh export and keep a backup.
For Docker, export onto the host, edit ./output/people.yaml, then import its container path:
(umask 077; docker compose exec -T immich-memories immich-memories people export > ./output/people.yaml)
docker compose exec immich-memories immich-memories people import --from /app/output/people.yaml --replace
--to people.yaml would write inside the container. The output mount exposes the edited file
to the app; umask 077 keeps a new export's names and birth dates private on the host.
Bind another account's face
When someone uploads through a second Immich account, their face can have another ID. Declare the connection instead of relying on matching names:
immich-memories people bind "Alex Example" --account partner --id PERSON_ID
Then include the account in a film with generate --accounts primary,partner. Second-account setup.
With immich.native_sharing: true, a shared Immich person ID that's already proven on one
account needs only this one binding: the app verifies it once against the other owner's
access and reuses it, instead of asking for a separate binding per account.
Saved groups
A group names a reusable people condition. Use the canonical IDs shown by people show:
immich-memories people group add kids '"PERSON_ID_A" OR "PERSON_ID_B"'
immich-memories people group list
immich-memories generate --memory-type multi_person --group kids --year 2025
immich-memories people group rm kids
Film titles use the saved people's names, not their internal IDs. Unnamed people still filter the film, but do not add an ID to its title.
Removing a group removes the label, not its people. The People page can create groups too; pick them on Memory.
The people registry reference documents inference, export format and ID validation. Every flag: CLI reference.