diff --git a/docs/cli.md b/docs/cli.md
index b88a6ca5d4..92c767ce8d 100644
--- a/docs/cli.md
+++ b/docs/cli.md
@@ -319,6 +319,16 @@ viam data database configure --org-id=abc --password=my_password123
 viam data database hostname --org-id=abc
 ```
 
+Viam currently only supports deleting approximately 500 files at a time.
+To delete more data iterate over the data with a shell script:
+
+```sh
+# deleting one hour of image data
+for i in {00..59}; do
+  viam data delete binary --org-ids=<org-id> --mime-types=image/jpeg,image/png --start=2024-05-13T11:00:00.000Z --end=2024-05-13T11:${i}:00.000Z
+done
+```
+
 #### Command options
 
 <!-- prettier-ignore -->