diff --git a/errors/react-hydration-error.mdx b/errors/react-hydration-error.mdx
index dae9eea68a05e5..e1c5e12ff2cf8a 100644
--- a/errors/react-hydration-error.mdx
+++ b/errors/react-hydration-error.mdx
@@ -75,6 +75,11 @@ Sometimes content will inevitably differ between the server and client, such as
 <time datetime="2016-10-25" suppressHydrationWarning />
 ```
 
+> **Good to know:**
+>
+> - This only works one level deep, and is intended to be an escape hatch. Don’t overuse it.
+> - React will **not** attempt to patch mismatched text content when `suppressHydrationWarning={true}` is set.
+
 ## Common iOS issues
 
 iOS attempts to detect phone numbers, email addresses, and other data in text content and convert them into links, leading to hydration mismatches.