Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

Clarification on profile and session

Magnus Müller5638bbdc72e0
diff --git a/docs/customize/browser-keep-open.mdx b/docs/customize/browser-keep-open.mdx
index 7e46d87c7..d4183209c 100644
--- a/docs/customize/browser-keep-open.mdx
+++ b/docs/customize/browser-keep-open.mdx
@@ -1,5 +1,5 @@
---
-title: "Reuse same browser"
+title: "Chain Agents"
description: ""
icon: "repeat"
mode: "wide"
diff --git a/docs/customize/browser-parameters.mdx b/docs/customize/browser-parameters.mdx
index d1ede2ae1..768ddbf79 100644
--- a/docs/customize/browser-parameters.mdx
+++ b/docs/customize/browser-parameters.mdx
@@ -9,7 +9,6 @@ mode: "wide"
### Core Settings
- `cdp_url`: CDP URL for connecting to existing browser instance (e.g., `http://localhost:9222`)
- `is_local` (default: `True`): Whether this is a local browser instance. Set to `False` for remote browsers
-- `browser_profile`: BrowserProfile template for reusable configuration
### Display & Appearance
- `headless` (default: `None`): Run browser without UI. Auto-detects based on display availability
@@ -80,4 +79,18 @@ mode: "wide"
- `deterministic_rendering` (default: `False`): ⚠️ NOT RECOMMENDED. Forces consistent rendering but reduces performance
- `cross_origin_iframes` (default: `False`): Enable cross-origin iframe support
----
\ No newline at end of file
+---
+
+## Outdated BrowserProfile
+For backward compatibility, you can pass all the parameters from above to the `BrowserProfile` and then to the `Browser`.
+```python
+from browser_use import BrowserProfile
+profile = BrowserProfile(headless=False, stealth=True)
+browser = Browser(browser_profile=profile)
+```
+
+
+## Browser vs BrowserSession
+
+`Browser` is an alias for `BrowserSession` - they are exactly the same class:
+Use `Browser` for cleaner, more intuitive code.
\ No newline at end of file