Browserbase Products
All Browserbase Release Notes
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
3.0.0
Speed boost 20-40% across act, extract, and observe with automatic caching and multi‑browser support. Built‑in primitives like page, locator, frameLocator and deepLocator, bun compatibility, and streamlined schemas. Targeted extract across iframes and shadow roots; migration guide advised.
Major Changes
- Removes internal Playwright dependency
- A generous 20-40% speed increase across act, extract, & observe calls
- Compatibility with Playwright, Puppeteer, and Patchright
- Automatic action caching (agent, stagehand.act). Go from CUA → deterministic scripts w/o inference
- A suite of non AI primitives:
- page
- locator (built in closed mode shadow root traversal, with xpaths & css selectors)
- frameLocator
- deepLocator (crosses iframes & shadow roots)
- bun compatibility
- Simplified extract schemas
- CSS selector support (id-based support coming soon)
- Targeted extract and observe across iframes & shadow roots
- More intuitive type names (observeResult is now action, act accepts an instruction string instead of an action string, solidified ModelConfiguration)
Check the migration guide for more information
Original source Report a problem - November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.5.0
New release adds stagehand.agent support for MCP servers and custom tools, plus patches for webvoyager evals, local MCP server connections, configurable base URLs for OpenAI provider and CUA, and GPT-5 support in the operator agent.
Minor Changes
- #981 8244ab2 Thanks @sameelarif ! - Added support for stagehand.agent to interact with MCP servers as well as custom tools to be passed in. For more information, reference the MCP integrations documentation
Patch Changes
- #959 09b5e1e Thanks @filip-michalsky ! - add webvoyager evals
- #1049 e3734b9 Thanks @miguelg719 ! - Support local MCP server connections
- #1025 be85b19 Thanks @tkattkat ! - add support for custom baseUrl within openai provider
- #1040 88d1565 Thanks @miguelg719 ! - Allow OpenAI CUA to take in an optional baseURL
- #1046 ab5d6ed Thanks @tkattkat ! - Add support for gpt-5 in operator agent
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.4.4
Patch Changes
- #1012 9e8c173 Thanks @miguelg719 ! - Fix disabling api validation whenever a customLLM client is provided
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.4.3
Patch notes announce GPT-5 API format changes and experimental shadow DOM support. It also fixes iframe behavior, improves image handling in the evaluator, and adds more stagehand evals. These are shipped product changes.
Patch Changes
- #951 f45afdc Thanks @miguelg719 ! - Patch GPT-5 new api format
- #954 261bba4 Thanks @seanmcguire12 ! - add support for shadow DOMs (open & closed mode) when experimental: true
- #944 8de7bd8 Thanks @seanmcguire12 ! - Bump zod version compatibility and add pathing spec
- #919 3d80421 Thanks @seanmcguire12 ! - enable scrolling inside of iframes
- #963 0ead63d Thanks @tkattkat ! - Properly handle images in evaluator + clean up response parsing logic
- #961 8422828 Thanks @tkattkat ! - Add more evals for stagehand agent
- #946 b769206 Thanks @seanmcguire12 ! - fix: unable to act on/get content from some same process iframes
- #962 72d2683 Thanks @seanmcguire12 ! - handle namespaced elements in xpath build step
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.4.2
Patch notes showcase safety and stability fixes across the API and UI, including type safety, tab handling, iframe/xpath bug fixes, and SDK version reporting. Cleanup of old images and obsolete methods also included.
Patch Changes
- #865 6b4e6e3 Thanks @seanmcguire12 ! - improve type safety for trimTrailingTextNode
- #897 e77d018 Thanks @miguelg719 ! - Fix selfHeal to remember intially received arguments
- #920 c20adb9 Thanks @seanmcguire12 ! - fix: tab handling on API
- #882 b86df93 Thanks @seanmcguire12 ! - remove elements that don't have xpaths from observe response
- #905 023c2c2 Thanks @tkattkat ! - Delete old images from anthropic cua client
- #925 8c28647 Thanks @miguelg719 ! - Remove _refreshPageFromApi()
- #887 87e09c6 Thanks @seanmcguire12 ! - fix: allow xpaths with prepended 'xpath=' for targeted extract
- #864 a611115 Thanks @miguelg719 ! - Temporarily patch custom clients serialization error on api
- #881 69913fe Thanks @miguelg719 ! - Pass sdk version number to API for debugging
- #913 b1b83a1 Thanks @seanmcguire12 ! - move iframe out of 'experimental'
- #891 be8497c Thanks @seanmcguire12 ! - fix: nested iframe xpath bug
- #883 98704c9 Thanks @seanmcguire12 ! - add timeout for JS click
- #907 04978bd Thanks @seanmcguire12 ! - store mapping of CDP frame ID -> page
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.4.1
Patch Changes
- #856 8a43c5a Thanks @seanmcguire12 ! - set download behaviour by default
- #857 890ffcc Thanks @miguelg719 ! - return "not-supported" for elements inside the shadow-dom
- #844 64c1072 Thanks @seanmcguire12 ! - don't automatically close tabs
- #860 b077d3f Thanks @miguelg719 ! - Set default schema on extract options with no schema
- #842 8bcb5d7 Thanks @seanmcguire12 ! - improved handling for OS level dropdowns
- #846 7bf10c5 Thanks @miguelg719 ! - Filter attaching to target worker / shared_worker
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.4.0
Frontend and tooling get a compact patch update with reliability fixes and new Claude 4 CUA support. The rollout switches test tooling to Playwright, tightens API key handling, adds date-tagged OpenAI CUA models, updates logos, and refines logging levels for clarity.
Minor Changes
- #819 6a18c1e Thanks @seanmcguire12 ! - try playwright click and fall back to JS click event
Patch Changes
- #826 124e0d3 Thanks @seanmcguire12 ! - fix issue where we are unable to take actions on text nodes
- #818 1660751 Thanks @miguelg719 ! - Added CUA support for Claude 4 models
- #821 cadac9d Thanks @seanmcguire12 ! - use playwright instead of playwright test
- #832 759da55 Thanks @miguelg719 ! - Fix _refreshPageFromAPI to use parametrized apiKey
- #810 a175a51 Thanks @miguelg719 ! - Update logos
- #822 8527a80 Thanks @miguelg719 ! - Add model with date tag for OpenAI CUA
- #833 55fca2f Thanks @seanmcguire12 ! - adjust stagehandLogger.warn() level to be 1 instead of 0
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.3.1
Patch Changes
- #796 12a99b3 Thanks @miguelg719 ! - Added a experimental flag to enable the newest and most experimental features
- #807 2451797 Thanks @seanmcguire12 ! - include version number in StagehandDefaultError message
- #803 1d631a5 Thanks @miguelg719 ! - Enable session affinity for cache optimization
- #804 9c398bb Thanks @seanmcguire12 ! - update operatorResponseSchema based on new openai spec
- #786 c19ad7f Thanks @miguelg719 ! - Handle reroute to account for rollout
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.3.0
Minor Changes
- #737 6ef6073 Thanks @seanmcguire12 ! - deprecate useTextExtract and remove functionality
Patch Changes
- #741 5680d25 Thanks @seanmcguire12 ! - use safeparse for zod validation
- #783 4de92a8 Thanks @miguelg719 ! - Fix the readme logo link
- November 2025
- No date parsed from source.
- Detected by Releasebot:Nov 1, 2025
2.2.1
Patch roundup delivers stability fixes and deprecations. Highlights: browser.close() fix, extract tweaks, deprecation of onlyVisible, safe describe with zod schemas, npm publishing changes, link schema fix, DOM accessibility cleanup, and optional API key for native AI SDK.
Patch Changes
- #721 be8652e Thanks @miguelg719 ! - Fix stagehand.close() functionality to include calling browser.close()
- #724 6b413b7 Thanks @seanmcguire12 ! - rm refine step in extract
- #712 7eafbd9 Thanks @seanmcguire12 ! - deprecated onlyVisible param and remove its functionality
- #725 1b50aa6 Thanks @seanmcguire12 ! - dont overwrite .describe() when user defines a zod schema with z.string().url().describe()
- #717 f2b7f1f Thanks @seanmcguire12 ! - don't publish uncompiled ts to npm
- #719 c8d672f Thanks @seanmcguire12 ! - fix Invalid schema for response_format error when extracting links
- #722 bebf204 Thanks @seanmcguire12 ! - replace NBSP with regular space & remove special characters from dom+a11y tree
- #714 37d6810 Thanks @miguelg719 ! - Fix the native AI SDK client implementation to optionally take in an API key