From 5d1d1901f764a440854cf0d08cd76b1dc6d49e4c Mon Sep 17 00:00:00 2001
From: Abhijeet Prasad <aprasad@sentry.io>
Date: Wed, 12 Nov 2025 14:10:53 -0500
Subject: [PATCH] fix: Update browser profiling docs for alert with local
 profiling with Chrome DevTools

Added warning about browserProfilingIntegration in Chrome DevTools.
---
 .../profiling/browser-profiling/javascript.mdx              | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/platform-includes/profiling/browser-profiling/javascript.mdx b/platform-includes/profiling/browser-profiling/javascript.mdx
index 64ed5a4800c8c..006027272058a 100644
--- a/platform-includes/profiling/browser-profiling/javascript.mdx
+++ b/platform-includes/profiling/browser-profiling/javascript.mdx
@@ -46,6 +46,12 @@ Configuration should happen as early as possible in your application's lifecycle
 
 <PlatformContent includePath="profiling/automatic-instrumentation-setup" />
 
+<Alert level="warning" title="Local Profiling with Chrome DevTools">
+
+When you enable `browserProfilingIntegration` in your SDK configuration, Chrome will incorrectly attribute regular rendering work as “Profiling Overhead” if you are doing local profiling via the Chrome DevTools Performance panel. To avoid this, disable or remove the integration when profiling with Chrome DevTools. 
+
+</Alert>
+
 ## The Difference Between DevTools & Sentry's JavaScript Browser Profiler
 
 What does Sentry's JavaScript browser profile offer that Chrome DevTools does not?