diff --git a/packages/docs/content/api.mdx b/packages/docs/content/api.mdx
index b7bf366ad..76897a4be 100644
--- a/packages/docs/content/api.mdx
+++ b/packages/docs/content/api.mdx
@@ -1031,6 +1031,12 @@ z.never(); // inferred type: `never`
 
 ## Objects
 
+
+<Callout type="warn"> 
+  Object methods (`.pick()`, `.omit()`, `.extend()`, etc.) will discard the refinements defined on the base object. However, `.safeExtend()` will preserve them.
+</Callout>
+
+
 To define an object type:
 
 ```ts z.object