diff --git a/docs/config.md b/docs/config.md
index b1f1e10525..31db843fcc 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -704,6 +704,27 @@ executable on your system](https://facebook.github.io/watchman/docs/install).
 
 Debugging commands are available under `jj debug watchman`.
 
+## Snapshot settings
+
+### Maximum size for new files
+
+By default, as an anti-footgun measure, `jj` will refuse to add new files to the
+snapshot that are larger than a certain size; the default is 1MiB. This can be
+changed by setting `snapshot.max-new-file-size` to a different value. For
+example:
+
+```toml
+snapshot.max-new-file-size = "10MiB"
+# the following is equivalent
+snapshot.max-new-file-size = 10485760
+```
+
+The value can be specified using a human readable string with typical suffixes;
+`B`, `MiB`, `GB`, etc. By default, if no suffix is provided, or the value is a
+raw integer literal, the value is in bytes.
+
+Files that already exist in the working copy are not subject to this limit.
+
 ## Ways to specify `jj` config: details
 
 ### User config file