Skip to content

Managing face clusters

When face recognition is on, Photogala automatically groups photos by person – each detected person becomes a cluster. As a moderator you organise these clusters: you give people a name, merge duplicate clusters, split wrongly grouped ones, hide irrelevant clusters and set a preview image. Well-kept clusters make the guest filter by people accurate.

Moderation lives in two places – with the same interface. Take the route your role gives you:

  1. As a host or admin: admin sidebar → Gallery group → Review & Reports. Face Clusters is also a sub-entry you can click directly.

    As a moderator: profile menu top right → Moderation.

  2. At the top, choose the Face Clusters tab.

Face cluster manager with search field, filter and cluster tiles
The cluster manager: search, the filter for unlabeled clusters, the counters and the clusters as tiles.

The top row controls the display:

Toolbar of the cluster manager with the search field and the Only unlabeled checkbox highlighted
1 the Search by name or ID field – jumps straight to people you already named, 2 the Only unlabeled checkbox – hides everything that already has a name. Together they let you work through the open clusters without losing track.
  • Search by name or ID – filters the clusters live by name or cluster ID.
  • Only unlabeled – hides every already-named cluster so you can focus on the open ones.
  • Total clusters and Showing – how many clusters exist and how many are visible after filtering.

Each cluster tile shows:

  • a preview face and the number of faces in the cluster;
  • a selection checkbox for merging (see below);
  • the nameUnlabeled at first – and below it the shortened cluster ID;
  • a Hide or Show button. Hidden clusters carry a red Hidden badge and a dashed border.

A name makes the cluster clear for you and for the guest filter. There are two ways to do it.

The fastest route when working through many clusters in a row – you don’t open a dialog at all.

  1. On the tile, click the name row (tag icon; on unnamed clusters it reads Unlabeled). It turns into a Person Name (optional) input field.

  2. Type the name and confirm with Enter or with OK. Cancel discards the change.

  3. A toast Label updated confirms it; the name appears on the tile right away.

Cluster tile in renaming mode with the Person Name (optional) field and the Cancel and OK buttons
Way A: clicking Unlabeled turns the name row into the Person Name (optional) field, with Cancel and OK below it. The other tiles stay untouched.
  1. Open the cluster by clicking the preview face. The Cluster details dialog opens.

  2. At the top, click Unlabeled - Click to name (pencil icon), enter the name in the Enter person name field and confirm with OK.

When the AI detects the same person as several separate clusters (different lighting, glasses, angle), merge them.

  1. Tick the checkbox on at least two tiles of the same person. A bar appears at the top with the number of selected clusters and a Merge button. With fewer than two selected, a toast says “Select at least 2 clusters to merge”.

    Two ticked cluster tiles with the bar above showing 2 selected, Clear and Merge
    Two tiles are ticked – they get a coloured ring and a check mark. The bar above counts 2 selected and offers Clear and Merge.
  2. Click Merge. The Merge Face Clusters dialog opens and names how many clusters are affected. You can optionally set a Person Name (optional) for the result right away.

    Merge Face Clusters dialog with the number of clusters, the Person Name (optional) field and the Cancel and Merge buttons
    The dialog names the count – 2 clusters here – and offers the Person Name (optional) field. Its note calls the source clusters *hidden*; in fact they vanish from the list entirely (see the warning below).
  3. Confirm with Merge.

If the AI put two people into one cluster, extract the wrong faces into a new cluster.

Cluster details dialog with selectable faces, confidence percentages and the Split and preview-image buttons
The Cluster details dialog: pick faces (with a confidence percentage) and extract them into a new cluster; the star sets the preview image.
  1. Open the cluster. The Cluster details dialog reads “Select faces to extract into a new cluster”. Every face carries a confidence percentage – how sure the match is. Low values (red or orange) are good candidates to sort out.

  2. Select the faces that don’t belong to this person. Select All and Clear help; the counter shows Selected: N / total.

  3. Optionally enter a New Cluster Label (optional) and click Split at the bottom. The chosen faces form their own cluster.

In the Cluster details dialog every face carries a star icon with the tooltip Set as preview. A click makes that photo the cluster’s preview image – handy when the automatic preview is blurry or not descriptive. The currently set face is marked Current preview, and a toast Preview image updated confirms the change.

At the top right of the Cluster details dialog there is a Refresh button (circular arrow). It reloads the faces of this cluster – useful when photos are still being processed in the background, or when you just split something and want to see the new state.

Not every cluster is relevant (background guests, blurry faces, strangers).

  • Hide removes the cluster from the people selection in the guest filter without deleting any photos. The cluster stays here with a Hidden badge. A toast confirms: “Cluster is now hidden”.
  • Show makes a hidden cluster available again (“Cluster is now visible”).
People and face selection in the filter
What the clusters are for shows up here for guests: the people selection in the gallery filter.

Face data is biometric, especially sensitive data. Guests have a right to erasure and can remove their selfie and face data themselves – see Your privacy. As the host you must enable face recognition deliberately and provide a contact for data-subject rights; background under AI processing.

  • No “Face Clusters” tab → AI face processing not in your plan, or face recognition off for the event.
  • No or few clusters → processing runs while photos are uploaded. New faces appear gradually; in the detail dialog use Refresh to reload.
  • Merge does nothing → fewer than two clusters are selected. Tick at least two tiles.
  • Split is rejected → you selected every face. At least one has to stay in the original cluster.
  • A cluster vanished after merging → that is intended: the source clusters are absorbed into the new cluster and do not reappear.
  • Wrong person in a cluster → use Split to extract the foreign faces into a new cluster.