Skip to main content

Duplicates Utility

Immich comes with a duplicates utility to help you detect assets that look visually similar. The duplicate detection feature relies on machine learning and is enabled by default. For more information about when the duplicate detection job runs, see Jobs and Workers. Once an asset has been processed and added to a duplicate group, it becomes available to review in the "Review duplicates" utility, which can be found here.

Reviewing duplicates

The review duplicates page allows the user to individually select which assets should be kept and which ones should be trashed. When more than one asset is kept, there is an option to automatically put the kept assets into a stack.

Automatic preselection

When using "Deduplicate All" or viewing suggestions, Immich automatically preselects which assets to keep based on:

  1. Image size in bytes — larger files are preferred as they typically have higher quality.
  2. Count of EXIF data — assets with more metadata are preferred.

Synchronizing metadata

When resolving duplicates, metadata from trashed assets is automatically synchronized to the kept asset. This synchronization only happens when exactly one asset is kept and at least one asset is trashed. When more than one asset is kept, metadata is not merged — the assets keep their own metadata and are simply removed from the duplicate group. The following metadata is synchronized:

NameDescription
AlbumThe kept asset will be added to every album that the other assets in the group belong to.
FavoriteIf any of the assets in the group have been added to favorites, the kept asset will also be added to favorites.
RatingIf one or more assets in the duplicate group have a rating, the highest rating is selected and synchronized to the kept asset.
DescriptionDescriptions from each asset are combined together and synchronized to the kept asset.
VisibilityThe most restrictive visibility is applied to the kept asset.
LocationLatitude and longitude are copied if all assets with geolocation data in the group share the same coordinates.
TagTags from all assets in the group are merged and applied to the kept asset.