diff --git a/docs/reference/slm/apis/slm-put.asciidoc b/docs/reference/slm/apis/slm-put.asciidoc
index b185ed82b3f7..ff11289f62f1 100644
--- a/docs/reference/slm/apis/slm-put.asciidoc
+++ b/docs/reference/slm/apis/slm-put.asciidoc
@@ -101,6 +101,10 @@ deletion.
 Maximum number of snapshots to retain, even if the snapshots have not yet
 expired. If the number of snapshots in the repository exceeds this limit, the 
 policy retains the most recent snapshots and deletes older snapshots.
++
+NOTE: The maximum number of snapshots in a repository should not exceed `200`. This ensures that the snapshot repository metadata does not
+grow to a size which might destabilize the master node. If the `max_count` setting is not set, this limit should be enforced by configuring
+other retention rules such that the repository size does not exceed `200` snapshots.
 
 `min_count`::
 (Optional, integer)