For AI agents: a documentation index is available at /llms.txt
Skip to main content

Enterprise Changelog

Note that these changes are only for Browserless' cloud, Enterprise and self-hosted Enterprise deployments. For information on the open-source container please refer to this link.

Latest

  • Updates to @browserless.io/browserless at v2.54.1.
  • Dependency updates.

v2.106.0

  • Dependency updates.
  • Updates to @browserless.io/browserless at v2.54.0.
  • Additional per-route metric.
  • Disable Chrome optimization-guide model downloads.
  • Return 403 when a navigation is blocked.
  • Drop Playwright 1.42 support and add Playwright 1.61.

v2.105.0

  • Dependency updates.
  • Add BQL mutations: emulateMediaType, addScriptTag, addStyleTag, fulfill, and markdown.
  • Extend BQL mutations: goto accepts referer, waitForSelector supports hidden, viewport supports hasTouch/landscape, and pdf supports fullPage.
  • Fix acceptInsecureCerts not taking effect in stealth mode.
  • Fix proxied requests.

v2.104.0

  • Add CDP proxy commands Browserless.uploadFile and Browserless.fileDownloaded.
  • Fix BQL stealth reconnect().

v2.103.0

  • Dependency updates.
  • Add 1Password credential support.
  • Unblock API reconnection fix.
  • Fix navigation guards.
  • /export with includeResources: true now bundles cross-origin assets.
  • Improve reCAPTCHA detection accuracy.

v2.102.0

  • Dependency updates.
  • Updates to @browserless.io/browserless at v2.52.2.
  • Add session-replay support to the /unblock endpoint.
  • Fix extension loading failures.

v2.101.0

  • Dependency updates.
  • Updates to @browserless.io/browserless at v2.52.1.
  • Allow MCP agents to create, save, and reuse browser profiles across sessions.
  • Log output re-leveled to surface warnings while reducing routine noise.
  • Isolate WebSocket errors in live URL, VHS recording, and CDP proxy sessions.
  • Add WS_MAX_PAYLOAD env var to raise the WebSocket payload limit for large CDP responses.
  • Additional metrics for per-route latency, queue wait, browser acquire time, and capacity gauges.

v2.100.0

  • Dependency updates.
  • Updates to @browserless.io/browserless at v2.52.0.
  • Add solve(type: audio) BQL mutation for solving reCAPTCHA v2 audio challenges.
  • Add datacenter proxy network alongside residential proxies for sessions, REST APIs, scraping, and BQL. Datacenter traffic is billed at a lower unit rate.
  • Fix if/ifnot BQL blocks running mutations in parallel instead of sequentially.
  • Fix stealth browser launch hanging when the blockAds or record is specified.

v2.99.1

  • Bug fixes.
  • Dependency updates.

v2.99.0

  • Dependency updates.
  • Add a hosted agent endpoint (/chromium/cli) where Browserless runs the LLM and drives the browser to complete a task, streaming progress to the CLI; LLM usage is billed as separate agent units.
  • Move the /unblock endpoint onto the BrowserQL stack, adding configurable waits, an optional WebSocket endpoint, and screenshots that honor the requested image format.
  • Add an Arkoselabs/FunCaptcha solver, detect captchas inside same-origin iframes, and improve rotate-captcha accuracy with honest solve reporting.
  • Make screenshots and PDFs best-effort after captcha solving, so a post-solve page navigation no longer fails the whole request.
  • Improve stealth realism so sessions more closely resemble a real-world browser (on by default).
  • Honor the operator argument in the waitForResponse, waitForRequest, if, and ifnot BQL mutations.
  • Return partial results from the BQL response() mutation when an individual response body is unavailable.
  • Bypass the limiter for BQL reconnect requests so in-progress sessions aren't dropped when a worker is under load.
  • Adjust consumption for requests that fail validation (for example a missing url).
  • Add OpenTelemetry session metrics (completed/rejected/active) and per-endpoint http.route span labels.

v2.98.1

  • Updates to @browserless.io/browserless at v2.51.1 — Node.js 24.16.0, NPM 11.16.0, and puppeteer-core 25.1.0.
  • New authenticate mutation.
  • Bug fixes

v2.98.0

  • Dependency updates.
  • Add a new authenticate BQL mutation for HTTP authentication.
  • Improve press and hold captcha solving.
  • Fix snapshot accessibility attribute type handling.
  • Improve secret redaction in OpenTelemetry observability data.

v2.97.1

  • Dependency updates.

v2.96.3

  • Improve Cloudflare and Turnstile captcha solving.
  • Improve stealth reliability against Cloudflare for Puppeteer and Playwright.
  • Return 429 for new sessions when the worker is at capacity.
  • Improve 429 observability in OpenTelemetry traces.
  • Add rotate captcha solving.

v2.96.2

  • Improve scrape, map, and search reliability on slow sites.

v2.96.1

  • Improve /smart-scrape reliability against protected sites with target-aware proxy selection and improved captcha detection and solving.
  • Improve /unblock reliability with a request-wide timeout deadline, more robust browser startup, and waitUntil support for finer navigation control.
  • Fix copy-paste in LiveURL when the viewer is embedded in a cross-origin iframe (such as the Browserless account app).

v2.96.0

  • Improve adblock list build resilience by falling back to a bundled snapshot when the upstream source is unreachable.

v2.95.2

  • Fix in-page WebSocket connections for /function and /download endpoints being blocked on HTTPS deployments due to mixed-content restrictions.

v2.95.1

  • Dependency updates.
  • Add Browserless.refreshProfile CDP method to update an existing profile's auth state in place without creating a duplicate.
  • Updates to @browserless.io/browserless at v2.49.0.
  • Reduce production Docker image size by removing development tooling from the final image.

v2.95.0

  • Dependency updates.
  • Fix billing and Browser Session Ended tracking for persistent session and reconnect WebSocket connections (/session/connect/:id and /reconnect/:id); each WebSocket connection is now billed independently, restoring usage accounting for persistent-session traffic.
  • Add POST /profile/upload and POST /profile/refresh endpoints to create a profile from a pre-captured auth state or replace an existing profile's state in place, with server-side sanitization of cookies, origins, and IndexedDB plus a diagnostics field describing what was filtered or truncated.
  • Fix LiveURL OAuth login for authenticated profiles, and default the browser type to stealth when creating a profile without specifying one.

v2.94.1

  • Dependency updates.
  • Cap live viewers at 5 per session ID on /live/<id> and return 429 Too Many Requests once exceeded, freeing slots automatically when viewers disconnect.
  • Include captcha detection and classification in snapshot captures, giving agents better visibility into security challenges encountered during automation.
  • Add an optional profile parameter to crawl requests for authenticated scraping; crawls now end early on critical errors, truncate oversized error messages, and return 503 if the profile service is unavailable.

v2.94.0

  • Updates to @browserless.io/browserless at v2.48.3.
  • Dependency updates.
  • Fix agent snapshot generation when pages contain malformed or empty HTML attributes, so snapshots no longer fail on attribute encoding edge cases.
  • Add an optional profile parameter to /scrape requests for server-side hydration of authenticated browser profiles; requests that use a profile now require an API token and return clearer validation errors.
  • LiveURL sessions now show distinct end-of-session messages for timeouts versus manual closures, and the message is delivered before the socket disconnects so users actually see it.
  • Credit limit error messages now link to https://browserless.io/account/upgrade instead of the generic account page, and have minor grammar fixes.

v2.93.0

  • Update @browserless.io/browserless to v2.48.2
  • Improve proxy city targeting
  • Add tab management methods for agents

v2.92.3

  • Add Akamai captcha solving support.

v2.92.2

  • Improve browser fingerprint consistency for CPU architecture and font rendering in Docker images.
  • Dependency updates

v2.92.1

  • Enable agentic browsing for all accounts
  • Dependency updates

v2.92.0

  • Add authenticated profiles: capture a logged-in browser's cookies, localStorage, and IndexedDB once via Browserless.saveProfile, then reuse on any session with ?profile=<name>.
  • Add HTTP API for profile lifecycle: POST /profile, GET /profiles, GET|PUT|DELETE /profile/:name.

v2.91.0

  • Add route for agentic browsing

v2.90.6

  • Set default /crawl scrape timeout to 150s.
  • Add customer.id to OpenTelemetry resource attributes.
  • Add Content-Disposition header for PDF API responses.
  • Improve hCaptcha handling by hiding the auto-challenge.
  • Cache uBOL-home release metadata in the adblock build.

v2.90.5

  • Update search limits: Free 1→3, Prototyping 3→5, Starter 5→10, Scale 10→20.
  • Dependency updates.

v2.90.4

  • Improve DataDome captcha solving reliability.

v2.90.3

  • Add captcha solving support for browser-use sessions.

v2.90.2

  • Add DataDome captcha solving support.
  • Improve smart-scrape captcha detection and post-challenge navigation.
  • Add captcha solving support for browser-use sessions.
  • Improve /crawl API with enhanced orchestration and documentation.
  • Fix timeout override for applicable routes.
  • Fix session TTL display for browser sessions.
  • Bug fixes and improvements.

v2.90.1

  • Bug fixes and improvements.

v2.90.0

  • New crawl API for scalable web crawling.
  • Fix BQL close() overwriting reconnect keepUntil with zero TTL.

v2.89.2

  • Updates to @browserless.io/browserless at v2.46.0.
  • Fix 400 errors caused by strict Record<string,string> types in API schemas.
  • Fix Docker multi-heavy base image tagging.
  • Dependency updates.

v2.89.1

  • Updates to @browserless.io/browserless at v2.45.0.
  • Fix proxy SSL certificate errors (ERR_CERT_AUTHORITY_INVALID).
  • Improve proxy vendor health checks and failover reliability.
  • Harden URL validation against SSRF and DNS rebinding.
  • Fix session TTL management.
  • Fix stopRecording hanging in certain error conditions.
  • Fix recording quality for VHS sessions.
  • Unify scrape format types across REST API schemas.

v2.89.0

  • Add metadata enrichment for /map endpoint.
  • Add option to transfer base64 instead of binary for recordings.
  • Fix liveURL blank screen.
  • Fix bypass CSP for virtual keyboard and emulated <select>s.
  • Fix high CPU consumption for /map.
  • Add --disable-component-extensions-with-background-pages to stealth args.

v2.88.2

  • Updates to browserless.io/browserless at v2.43.0.

v2.88.1

  • New /map API.
  • Add emulateComponents option for liveURL.
  • Dependency updates.

v2.87.0

  • Deprecate codes in waitForResponse mutation, favoring statuses instead.
  • Fix <select /> elements in liveURL view.
  • Enable uploaded extensions cache.
  • New /search API.

v2.86.1

  • Power-scrape endpoint is now smart-scrape.
  • Improve Turnstile captcha detection and solving.
  • Improve session replay in reconnect sessions.
  • Improve stealth chromium for persistent sessions.

v2.86.0

  • Updates to browserless.io/browserless at v2.42.0.
  • Updates NodeJS to 24.14.0.
  • Supports puppeteer-core version 24.37.5.
  • Dependency updates.
  • Added support for loading extensions from session metadata.

v2.85.1

  • Supports HTTPs third party proxies in BQL
  • Fixes mobile typing bug in liveURL

v2.85.0

  • Updates to browserless.io/browserless at v2.41.0.
  • Supports puppeteer-core version 24.37.4.
  • OTEL support.

v2.84.2

  • Fix power scraper initialization bug

v2.84.1

  • Fix query param validation bug

v2.84.0

  • New power scrape endpoint for intelligent content extraction.
  • Fix external proxies in BQL incorrectly charging proxy units.

v2.83.0

  • Fix proxy consumption bug
  • Fix screencasting video dimensions
  • Improve docker image size

v2.82.1

  • Bug fixes.

v2.82.0

  • Added new proxy vendor.
  • New processKeepAlive flag.
  • Fix screencasting video dimensions.
  • liveURL connection issues.

v2.81.0

  • Updates to browserless.io/browserless at v2.39.0.
  • Session replay improvements.
  • Improve proxy mutations in BQL.
  • Additional captchas support.
  • Supports playwright-core versions 1.41.2, 1.42.1, 1.43.1, 1.44.1, 1.45.3, 1.46.1, 1.47.2, 1.48.2, 1.49.1, 1.50.1, 1.51.1, 1.52.0, 1.53.2, 1.54.2, 1.55.1, 1.56.1, 1.57.0 and 1.58.1.
  • Supports puppeteer-core version 24.36.1.

v2.80.1

  • Improve CAPTCHA detection and solving.
  • Support for external proxy server parameter.

v2.80.0

  • Updates to browserless.io/browserless at v2.38.4.
  • Updates NodeJS to 24.13.0.
  • Improve captcha solving performance.
  • Additional captchas support.
  • Supports playwright-core versions 1.41.2, 1.42.1, 1.43.1, 1.44.1, 1.45.3, 1.46.1, 1.47.2, 1.48.2, 1.49.1, 1.50.1, 1.51.1, 1.52.0, 1.53.2, 1.54.2, 1.55.1, 1.56.1 and 1.57.0.
  • Supports puppeteer-core version 24.36.0.

v2.79.2

  • Improve CAPTCHA detection and solving.

v2.79.1

  • Improve liveURL rendering in high DPI displays.
  • Bug fixes.

v2.79.0

  • Improve CAPTCHA detection mechanism.
  • Fix bug where deeply nested elements weren't found in nested shadow DOMs

v2.78.3

  • Improved BQL proxy URL regeneration on reconnects
  • Streamlined event logging

v2.78.2

  • Improved proxy connection reliability

v2.78.1

  • Upgraded browser tracking TTL

v2.78.0

  • Improved stealth and bot detection evasion capabilities

v2.77.1

  • Fix black screen issue with live urls

v2.77.0

  • New MAX_RECONNECT_TIME launch flag
  • Ensure the WS connection is always closed when using the /kill endpoint
  • Improve captcha detection
  • Fix bug in live URL that added an offset to mouse events

v2.76.0

  • Improve proxy reliability and performance
  • Fix third party proxies for BQL
  • Improve captcha solving performance

v2.75.0

  • Improved proxy reliability and performance
  • Enhanced captcha detection
  • Better stealth mode compatibility
  • Session replay improvements

v2.74.4

  • Stealth route enhancements
  • Connection stability improvements

v2.74.3

  • Enhanced captcha handling

v2.74.2

  • Bug fixes and improvements

v2.74.1

  • Added proxy provider configuration options

v2.74.0

  • Dependency updates
  • Improved captcha support for BQL
  • Performance optimizations

v2.73.2

  • Improve Residential Proxy Quality

v2.73.1

  • Minor improvements in liveURL client

v2.73.0

  • Add proxyLocaleMatch parameter to set browser language based on proxy country
  • Fix BQL session replay

v2.72.1

  • Deprecate verify mutation
  • Improve captcha callback function caller
  • Improve internal logs

v2.72.0

  • Added new proxy vendor
  • New solveImageCaptcha mutation
  • Better handle proxy requests that contains cities

v2.71.1

  • Fix bug in /unblock API where it errored if the screenshot parameter was not set
  • Allow all paid accounts to use the screencasting API

v2.71.0

  • Implemented new proxy provider
  • Improved Cloudflare CAPTCHA solver

v2.70.2

  • Updated proxy provider priority

v2.70.1

  • Improved recaptcha-v3 solver for speed and reliability improvements
  • Added /proxy/cities API endpoint for getting a list of supported proxy cities
  • Improved selectors for normal captcha, and Cloudflare captcha

v2.70.0

  • Improved recaptcha v3 support
  • Add fallback between captcha solvers
  • Improve event logging

v2.69.1

  • Dependency updates.
  • Improved recaptcha v2 support in stealth routes

v2.69.0

  • Match the browsers to the stealth endpoints.
  • Cloudflare captcha tracking improvements

v2.68.5

  • Added support for Turnstile Cloudflare captcha
  • Fixed amplitude attempt events to track Cloudflare captchas correctly
  • Added captcha subtype to amplitude events

v2.68.4

  • clean disk space before building docker images

v2.68.3

  • Restore automation of timezone and add proxy city validation changes

v2.68.1

  • Dependency updates.
  • Bug fixes and improvements

v2.68.0

  • Dependency updates.
  • Allow --disable-bundled-ppapi-flash, --disable-dev-shm-usage, --disable-domain-reliability, --disable-gpu, --disable-speech-api, --disable-webgl, and --wm-window-animations-disabled flags to be used.
  • Improve CAPTCHA solvers.

v2.67.1

  • Bug fixes and improvements

v2.67.0

  • Updates to browserless.io/browserless at v2.38.2.
  • Supports playwright-core versions 1.41.2, 1.42.1, 1.43.1, 1.44.1, 1.45.3, 1.46.1, 1.47.2, 1.48.2, 1.49.1, 1.50.1, 1.51.1, 1.52.0, 1.53.2, 1.54.2, and 1.55.1.
  • Supports puppeteer-core version 24.26.1.
  • Allow using Brave on BQL
  • Captcha selector fixes

v2.66.2

  • Critical security bug fix

v2.66.1

  • Critical security bug fix

v2.66.0

  • Revert proxy city and timezone changes
  • Upgrade Playwright, Puppeteer and Browserless
  • Upgrade Chrome to 141.0
  • Support for Capy challenges

v2.65.2

  • Improve CAPTCHA detection and solving.

v2.65.1

  • Add city database for proxy validation
  • Validate cities against supported proxy providers
  • Automate timezone based on proxy location

v2.65.0

  • Dependency updates
  • New @export directive
  • Fix timeout in solve captcha mutations
  • Normalize allowed cities for proxies
  • Fix Amplitude IDs for sessions

v2.64.3

  • Fix Amplitude logging error

v2.64.1

  • Allow using solveCaptchas on stealth routes.

v2.64.0

  • Dependency updates.
  • New feature: auto solve captcha.
  • Improve captcha resolution state polling.
  • Fix captcha solving edge cases.

v2.63.3

  • Dependency updates.
  • Log more event properties on Captcha Solve Error events.
  • Allow sending acceptInsecureCerts as query param.
  • Improve captcha-solving parameter sanitation.

v2.63.2

  • Dependency updates.
  • Updates to @browserless.io/browserless 2.37.1.

v2.63.1

  • Dependency updates.
  • Switches to ioredis for cloud-unit platform.

v2.63.0

  • Dependency updates.
  • Major /stealth route enhancements.
  • Many testing updates for internal stability.
  • Fixes BrowserQL goto calls that return a chrome-related error.
  • Other fixes and updates for stealth and captcha solving.

v2.62.1

  • Dependency updates.
  • Better timeout messages on cloud platform.
  • Other testing fixes.

v2.62.0

  • Dependency updates.
  • Update to @browserless.io/browserless 2.37.0.
  • Minor build updates and unit-test enhancements.
  • BrowserQL click mutation fixes and reliability improvements.
  • Fix /pdf, /screenshot and other REST APIs with requestInterceptors that contain base64 responses.
  • Other minor fixes and improvements.

v2.61.2

  • Dependency updates.
  • Cleanup of internal docs.
  • Fixes an issue with /unblock API's waitForFn properties.

v2.61.1

  • Dependency updates.
  • Fixes an issue where /unblock might orphan the browser process.
  • Logging and analytics improvements in cloud.

v2.61.0

  • Dependency updates.
  • Update to Ubuntu 24.04.
  • Update @browserless.io/browserless to 2.36.0.
  • New switchToWindow BrowserQL API.
  • Stealth enhancements and updates.
  • Prettier changes on source, logging cleanup.

v2.60.1

  • Dependency updates.
  • BrowserQL documentation updates and enhancements.
  • Analytical improvements on the cloud-unit platform.

v2.60.0

  • Dependency updates.
  • Replay feature is now shipped for cloud-unit.
  • Documentation cleanup and updates.
  • Updated request parsing and parameter handling.
  • Hybrid URL logging clean up.
  • Stealth enhancements and improvements.

v2.59.0

  • Dependency updates.
  • Stealth updates to all stealth enabled routes.
  • Fixes and updates to our captcha-solving capabilities.
  • Use npm ci for production builds (prevents unintentional package updates).
  • Other fixes and updates.

v2.57.0

  • New fingerprint management and rotation for browserless' /stealth CDP routes!
  • Updates to browserless.io/browserless@2.34.1
  • Supports playwright-core versions 1.41.2, 1.42.1, 1.43.1, 1.44.1, 1.45.3, 1.46.1, 1.47.2, 1.48.2, 1.49.1, 1.50.1, 1.51.1, 1.52.0, 1.53.1, and 1.54.2.
  • Supports puppeteer-core version 24.16.2.
  • Captcha solving updates and improvements.

v2.56.0

  • Updates to browserless.io/browserless at v2.34.0.
  • Supports playwright-core versions 1.41.2, 1.42.1, 1.43.1, 1.44.1, 1.45.3, 1.46.1, 1.47.2, 1.48.2, 1.49.1, 1.50.1, 1.51.1, 1.52.0, 1.53.1, and 1.54.2.
  • Supports puppeteer-core version 24.16.1.
  • Supports using of Chrome Extensions in cloud-unit products. Please refer to documentation on how to use this new feature.
  • Sessions API now support interoperability with BrowserQL.
  • Introduces a new vendor for Captcha Solving.
  • New environment variables:
    • EXTENSIONS_DIR The directory to store extensions onto.
    • LOAD_EXTENSIONS_FROM_CLOUD Whether or not to load extensions from a S3 compatible URL.
    • EXTENSIONS_CLOUD_BUCKET The bucket for extensions to be loaded from.
    • EXTENSIONS_CLOUD_REGION The region to load extensions from.
    • CAPSOLVER_API_KEY An API key to use for when Capsolver is used for captcha solving.

v2.55.0

  • Dependency updates.
  • Reverts some breaking stealth changes in favor of stability.
  • Adds a "mode" option in BQL's removeAttributes parameter for better HTML parsing.

v2.54.0

  • Dependency updates.
  • New LiveURL updates that include an optional showBrowserInterface for rendering all the tabs.
  • Fixes some issues with stealth and headers that Chrome generates.

v2.53.1

  • Revert live-URL updates until they're backwards compatible.

v2.53.0

  • Dependency updates.
  • New viewport API for BQL.
  • Consolidation of some internal utilities for consistency sake.
  • Big improvements to the /stealth routes for CDP libraries.
  • You can solveCaptcha without specifying the vendor in BQL.
  • Support for proxying through residential proxy providers.
  • Fixes an issue in BQL that can cause a browser to stay open when navigating.
  • LiveURL can now support multi-tabs workflows.
  • Testing fixes.

v2.52.4

  • Fixes an issue when deleting sessions

v2.52.3

  • Updates to proxying for future compatibility

v2.52.2

  • Fixes an issue where proxying can cause un-necessary latency

v2.52.1

  • Fix BQL navigation not filtering out iframe page events.

v2.52.0

  • Dependency updates.
  • Fixes navigation (goto, back, forward) issues in BQL for goto, forward and backward actions.
  • blockConsentModal is now default to false in BQL as it sometimes causes sites to hang indefinitely when loading.
  • New amazonWaf for BQL captcha solving.
  • New downloading handling forcing all downloads to be in a configurable path by setting a DOWNLOAD_DIR.
  • Fix page's created by playwright's context object hanging.
  • Fix issues with CDP-based screen-recording.
  • Other fixes, improvements, and reliability enhancements.
  • Bumps puppeteer-core to 24.12.1.
  • Bumps playwright-core to 1.54.1.
  • Drops support for playwright-core at 1.49.
  • Supports:
    • puppeteer-core: 24.12.1
    • playwright-core: 1.41.2, 1.42.1, 1.43.1, 1.44.1, 1.45.3, 1.46.1, 1.47.2, 1.48.2, 1.49.1, 1.50.1, 1.51.1, 1.52.0,
    • Chromium: 139.0.7258.5
    • Firefox: 140.0.2
    • Webkit: 26.0
    • Chrome: 138.0.7204.101 (amd64 only)
    • Edge: 138.0.3351.83 (amd64 only)