diff --git a/docs/usage/check.rst.inc b/docs/usage/check.rst.inc
index e9669bbe9..7b8018f89 100644
--- a/docs/usage/check.rst.inc
+++ b/docs/usage/check.rst.inc
@@ -115,6 +115,10 @@ Second, the consistency and correctness of the archive metadata is verified:
 - In repair mode, when all the archives were checked, orphaned chunks are deleted
   from the repo. One cause of orphaned chunks are input file related errors (like
   read errors) in the archive creation process.
+- In verify-data mode, a complete cryptographic verification of the archive data
+  integrity is performed. This conflicts with ``--repository-only`` as this mode
+  only makes sense if the archive checks are enabled. The full details of this mode
+  are documented below.
 - If checking a remote repo via ``ssh:``, the archive check is executed on the
   client machine because it requires decryption, and this is always done client-side
   as key access is needed.
diff --git a/src/borg/archiver.py b/src/borg/archiver.py
index bcae215f7..db34c370c 100644
--- a/src/borg/archiver.py
+++ b/src/borg/archiver.py
@@ -3127,6 +3127,10 @@ class Archiver:
         - In repair mode, when all the archives were checked, orphaned chunks are deleted
           from the repo. One cause of orphaned chunks are input file related errors (like
           read errors) in the archive creation process.
+        - In verify-data mode, a complete cryptographic verification of the archive data
+          integrity is performed. This conflicts with ``--repository-only`` as this mode
+          only makes sense if the archive checks are enabled. The full details of this mode
+          are documented below.
         - If checking a remote repo via ``ssh:``, the archive check is executed on the
           client machine because it requires decryption, and this is always done client-side
           as key access is needed.