diff --git a/.env.example b/.env.example
index 272bacd..389fbe1 100644
--- a/.env.example
+++ b/.env.example
@@ -125,6 +125,16 @@ THUMB_CONCURRENCY=0
 # ---------------------------------------------------------------------------
 IMPORT_PATH=/data/import
 
+# ---------------------------------------------------------------------------
+# Duplicate detection
+# ---------------------------------------------------------------------------
+# Maximum perceptual-hash distance (Hamming, out of 64 bits) for two files to be
+# treated as duplicate candidates. Lower = stricter (fewer, more confident
+# matches); higher = looser (catches more re-encodes/resizes but risks false
+# positives). Used only by the dedup tool's pairs rebuild — see the dedup CLI /
+# `docker compose run --rm dedup`. Default 10.
+DUPLICATE_HASH_THRESHOLD=10
+
 # ---------------------------------------------------------------------------
 # Static SPA
 # ---------------------------------------------------------------------------