You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/customize/browser-settings.mdx
+21-21Lines changed: 21 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,21 +28,21 @@ config = BrowserConfig(
28
28
29
29
## Core Settings
30
30
31
-
-**headless** (default: `False`)
31
+
-**headless** (default: `False`)
32
32
Runs the browser without a visible UI. Note that some websites may detect headless mode.
33
33
34
-
-**disable_security** (default: `True`)
34
+
-**disable_security** (default: `True`)
35
35
Disables browser security features. While this can fix certain functionality issues (like cross-site iFrames), it should be used cautiously, especially when visiting untrusted websites.
36
36
37
37
### Additional Settings
38
38
39
-
-**extra_chromium_args** (default: `[]`)
40
-
Additional arguments passed to the browser at launch. See the [full list of available arguments](https://github.com/browser-use/browser-use/blob/main/browser_use/browser/browser.py#L154).
39
+
-**extra_chromium_args** (default: `[]`)
40
+
Additional arguments passed to the browser at launch. See the [full list of available arguments](https://github.com/browser-use/browser-use/blob/main/browser_use/browser/browser.py#L180).
41
41
42
-
-**proxy** (default: `None`)
42
+
-**proxy** (default: `None`)
43
43
Standard Playwright proxy settings for using external proxy services.
Time to wait for network activity to cease. Increase to 3-5s for slower websites. This tracks essential content loading, not dynamic elements like videos.
141
141
142
-
-**maximum_wait_page_load_time** (default: `5.0`)
142
+
-**maximum_wait_page_load_time** (default: `5.0`)
143
143
Maximum time to wait for page load before proceeding.
Browser window dimensions. The default size is optimized for general use cases and interaction with common UI elements like cookie banners.
149
149
150
-
-**locale** (default: `None`)
150
+
-**locale** (default: `None`)
151
151
Specify user locale, for example en-GB, de-DE, etc. Locale will affect navigator.language value, Accept-Language request header value as well as number and date formatting rules. If not provided, defaults to the system default locale.
152
152
153
-
-**highlight_elements** (default: `True`)
153
+
-**highlight_elements** (default: `True`)
154
154
Highlight interactive elements on the screen with colorfull bounding boxes.
155
155
156
-
-**viewport_expansion** (default: `500`)
156
+
-**viewport_expansion** (default: `500`)
157
157
Viewport expansion in pixels. With this you can controll how much of the page is included in the context of the LLM. If set to -1, all elements from the entire page will be included (this leads to high token usage). If set to 0, only the elements which are visible in the viewport will be included.
158
158
Default is 500 pixels, that means that we inlcude a little bit more than the visible viewport inside the context.
159
159
160
-
### Restrict URLs
160
+
### Restrict URLs
161
161
162
-
-**allowed_domains** (default: `None`)
163
-
List of allowed domains that the agent can access. If None, all domains are allowed.
162
+
-**allowed_domains** (default: `None`)
163
+
List of allowed domains that the agent can access. If None, all domains are allowed.
164
164
Example: ['google.com', 'wikipedia.org'] - Here the agent will only be able to access google and wikipedia.
165
165
166
166
### Debug and Recording
167
167
168
-
-**save_recording_path** (default: `None`)
168
+
-**save_recording_path** (default: `None`)
169
169
Directory path for saving video recordings.
170
170
171
-
-**trace_path** (default: `None`)
171
+
-**trace_path** (default: `None`)
172
172
Directory path for saving trace files. Files are automatically named as `{trace_path}/{context_id}.zip`.
0 commit comments