diff --git a/src/includes/configuration/extra-error-data/javascript.mdx b/src/includes/configuration/extra-error-data/javascript.mdx
index 8a2490837981f..711ada9cf8428 100644
--- a/src/includes/configuration/extra-error-data/javascript.mdx
+++ b/src/includes/configuration/extra-error-data/javascript.mdx
@@ -6,9 +6,11 @@ Sentry.init({
   dsn: "___PUBLIC_DSN___",
   integrations: [new ExtraErrorDataIntegration(
     {
-      // limit of how deep the object serializer should go. Anything deeper than limit will
+      // Limit of how deep the object serializer should go. Anything deeper than limit will
       // be replaced with standard Node.js REPL notation of [Object], [Array], [Function] or
       // a primitive value. Defaults to 3.
+      // When changing this value, make sure to update `normalizeDepth` of the whole SDK
+      // to `depth + 1` in order to get it serialized properly - https://docs.sentry.io/platforms/javascript/configuration/options/#normalize-depth
       depth: number;
     }
   )],
@@ -32,9 +34,11 @@ Sentry.init({
   dsn: "___PUBLIC_DSN___",
   integrations: [new Sentry.Integrations.ExtraErrorData(
     {
-      // limit of how deep the object serializer should go. Anything deeper than limit will
+      // Limit of how deep the object serializer should go. Anything deeper than limit will
       // be replaced with standard Node.js REPL notation of [Object], [Array], [Function] or
       // a primitive value. Defaults to 3.
+      // When changing this value, make sure to update `normalizeDepth` of the whole SDK
+      // to `depth + 1` in order to get it serialized properly - https://docs.sentry.io/platforms/javascript/configuration/options/#normalize-depth
       depth: number;
     }
   )],