diff --git a/website/content/api-docs/secret/identity/entity.mdx b/website/content/api-docs/secret/identity/entity.mdx
index 0d2e16fd7f..a70330c3d8 100644
--- a/website/content/api-docs/secret/identity/entity.mdx
+++ b/website/content/api-docs/secret/identity/entity.mdx
@@ -400,6 +400,13 @@ Note that if these entities contain aliases sharing the same mount accessor, the
 entities must be merged one at a time. This is because each entity can only have one alias with each mount accessor - for more
 information, see the [identity concepts page](/vault/docs/concepts/identity).
 
+<Warning>
+
+We recommended limiting merging to the leader node of your primary cluster.
+
+</Warning>
+
+
 | Method | Path                     |
 | :----- | :----------------------- |
 | `POST` | `/identity/entity/merge` |