diff --git a/docs/docs/troubleshooting/img/brave-shields.png b/docs/docs/troubleshooting/img/brave-shields.png
new file mode 100644
index 000000000..133cd2876
Binary files /dev/null and b/docs/docs/troubleshooting/img/brave-shields.png differ
diff --git a/docs/docs/troubleshooting/studio.md b/docs/docs/troubleshooting/studio.md
index b88db0e3c..278d94cef 100644
--- a/docs/docs/troubleshooting/studio.md
+++ b/docs/docs/troubleshooting/studio.md
@@ -2,17 +2,17 @@
 
 ## :fontawesome-brands-safari:{ .safari } Safari connection error with local dev server
 
-Safari blocks plain‑HTTP traffic on localhost. If you start Studio with a vanilla  
-`langgraph dev`, the page may report a "Failed to load assistants" error (or something similar) and the browser DevTools will show network errors.
+Safari blocks plain‑HTTP traffic on localhost. If you start Studio with a vanilla `langgraph dev`, the page may report a "Failed to load assistants" error and the browser DevTools will show network errors.
 
 #### Quick fix — run Studio through a secure Cloudflare tunnel
 
 === "Python"
 
     ```shell
-    pip install -U langgraph-cli>=0.2.6            # Python
+    pip install -U langgraph-cli>=0.2.6
     langgraph dev --tunnel
     ```
+
 === "JS"
 
     ```shell
@@ -25,17 +25,18 @@ The command prints a URL like:
 ```shell
 https://smith.langchain.com/studio/?baseUrl=https://hamilton-praise-heart-costumes.trycloudflare.com
 ```
+
 where
+
 ```shell
 ?baseUrl=https://hamilton-praise-heart-costumes.trycloudflare.com
 ```
-indicates the endpoint where your agent server is exposed.
 
-Open that URL in Safari and Studio should load immediately.
+indicates the endpoint where your agent server is exposed. Open that URL in Safari and Studio should load immediately.
 
 #### Alternative — use a Chromium‑based browser
 
-Chrome, Edge, and Brave allow HTTP on localhost, so a plain `langgraph dev` should work without extra steps.
+Chrome and other Chromium‑based browsers allow HTTP on localhost, so a plain `langgraph dev` should work without extra steps.
 
 #### If it’s still not loading
 
@@ -43,3 +44,43 @@ Chrome, Edge, and Brave allow HTTP on localhost, so a plain `langgraph dev` sho
 2. Confirm your CLI version with `langgraph --version`.
 
 No other configuration, certificates, or CORS tweaks are required.
+
+## :fontawesome-brands-brave:{ .brave } Brave connection error with local dev server
+
+By default, Brave blocks plain‑HTTP traffic on localhost if Brave Shields are enabled. If you start Studio with a vanilla `langgraph dev`, the page may report a "Failed to load assistants" error and the browser DevTools will show network errors.
+
+#### Quick fix — disable Brave Shields for LangSmith
+
+Click the Brave icon next to the URL bar and turn off the Brave Shields in the popover.
+
+![Brave Shields](./img/brave-shields.png)
+
+#### Alternative — run Studio through a secure Cloudflare tunnel
+
+=== "Python"
+
+    ```shell
+    pip install -U langgraph-cli>=0.2.6
+    langgraph dev --tunnel
+    ```
+
+=== "JS"
+
+    ```shell
+    # Requires @langchain/langgraph-cli>=0.0.26
+    npx @langchain/langgraph-cli dev
+    ```
+
+The command prints a URL like:
+
+```shell
+https://smith.langchain.com/studio/?baseUrl=https://hamilton-praise-heart-costumes.trycloudflare.com
+```
+
+where
+
+```shell
+?baseUrl=https://hamilton-praise-heart-costumes.trycloudflare.com
+```
+
+indicates the endpoint where your agent server is exposed. Open that URL in Brave and Studio should load immediately.