diff --git a/docs/media-scraper.md b/docs/media-scraper.md
index 9f6baf0..c6d2584 100644
--- a/docs/media-scraper.md
+++ b/docs/media-scraper.md
@@ -118,6 +118,11 @@ Downloads run after a finished walk when the scrape used `mode: "download"`:
   durations come from Discord; the 0 that Discord sends for non-audio files is treated as unknown.
 - Progress counters: `downloaded`, `downloadErrors`.
 
+Previews cycle with the walk: after every `VESKSLOP_MEDIA_WALK_CYCLE_PAGES` pages (default 5) the
+engine previews up to one batch (`VESKSLOP_MEDIA_PREVIEW_BATCH`, default 25), then keeps walking,
+so tiles fill in during a long walk instead of only at the end. Set the cycle to `0` to defer all
+previews to the end.
+
 Previews run after every walk:
 
 - In both modes, Discord-hosted image, GIF, and **video** URLs (`cdn.discordapp.com`,