diff --git a/docs/records.md b/docs/records.md
index d287d8a..4cf1e4b 100644
--- a/docs/records.md
+++ b/docs/records.md
@@ -120,3 +120,18 @@ If you'd like to enable lenience for a whole zone you can do so with the followi
     targets:
     - ns1
 ```
+
+#### Restrict Record manipulations
+
+OctoDNS currently provides the ability to limit the number of updates/deletes on 
+DNS records by configuring a percentage of allowed operations as a threshold.
+If left unconfigured, suitable defaults take over instead. In the below example, 
+the Dyn provider is configured with limits of 40% on both update and 
+delete operations over all the records present.
+
+````yaml
+dyn:
+    class: octodns.provider.dyn.DynProvider
+    update_pcent_threshold: 0.4
+    delete_pcent_threshold: 0.4
+````