Skip to content

High performance self-hosted photo and video management solution.

docs: clarify duplicate exif merging intent (#29203)

Timon95fc5e968241
diff --git a/docs/docs/features/duplicates-utility.md b/docs/docs/features/duplicates-utility.md
index f790c42708..5d68c0ace9 100644
--- a/docs/docs/features/duplicates-utility.md
+++ b/docs/docs/features/duplicates-utility.md
@@ -15,14 +15,14 @@ When using "Deduplicate All" or viewing suggestions, Immich automatically presel
### Synchronizing metadata
-When resolving duplicates, metadata from trashed assets is automatically synchronized to the kept assets. The following metadata is synchronized:
-
-| Name | Description |
-| ----------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| Album | The kept assets will be added to _every_ album that the other assets in the group belong to. |
-| Favorite | If any of the assets in the group have been added to favorites, every kept asset will also be added to favorites. |
-| Rating | If one or more assets in the duplicate group have a rating, the highest rating is selected and synchronized to the kept assets. |
-| Description | Descriptions from each asset are combined together and synchronized to all the kept assets. |
-| Visibility | The most restrictive visibility is applied to the kept assets. |
-| Location | Latitude and longitude are copied if all assets with geolocation data in the group share the same coordinates. |
-| Tag | Tags from all assets in the group are merged and applied to every kept asset. |
+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:
+
+| Name | Description |
+| ----------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| Album | The kept asset will be added to _every_ album that the other assets in the group belong to. |
+| Favorite | If any of the assets in the group have been added to favorites, the kept asset will also be added to favorites. |
+| Rating | If one or more assets in the duplicate group have a rating, the highest rating is selected and synchronized to the kept asset. |
+| Description | Descriptions from each asset are combined together and synchronized to the kept asset. |
+| Visibility | The most restrictive visibility is applied to the kept asset. |
+| Location | Latitude and longitude are copied if all assets with geolocation data in the group share the same coordinates. |
+| Tag | Tags from all assets in the group are merged and applied to the kept asset. |