diff --git a/docs/platforms/javascript/common/configuration/options.mdx b/docs/platforms/javascript/common/configuration/options.mdx
index 0097015545f85..f5295488fb518 100644
--- a/docs/platforms/javascript/common/configuration/options.mdx
+++ b/docs/platforms/javascript/common/configuration/options.mdx
@@ -341,6 +341,18 @@ By the time `beforeSend` is executed, all scope data has already been applied to
 
 </SdkOption>
 
+<SdkOption name="enhanceFetchErrorMessages" type="'always' | 'report-only' | false" defaultValue="'always'">
+
+Controls whether and how to enhance fetch error messages by appending the request hostname. Generic fetch errors like "Failed to fetch" will be enhanced to include the hostname (e.g., "Failed to fetch (example.com)") to provide better context in Sentry.
+
+Available options:
+
+- `'always'` (default): Modifies the actual error message directly. This may break third-party packages that rely on exact message matching (e.g., `is-network-error`, `p-retry`).
+- `'report-only'`: Only enhances the message when sending to Sentry. The original error message remains unchanged, preserving compatibility with third-party packages that check error messages.
+- `false`: Disables hostname enhancement completely.
+
+</SdkOption>
+
 <SdkOption name="ignoreErrors" type='Array<string | RegExp>' defaultValue='[]'>
 
 <Include name="platforms/configuration/options/ignore-errors.mdx" />