How to use Stealth Mode for CAPTCHA solving and anti-bot avoidance.
Morally “good” automations play a vital role in modern web development with automated browsers performing legitimate tasks like testing, scraping, and content aggregation. While anti-bot systems often block all automation by default, you can be a good citizen of the web by using tools that respect site resources and terms of service.
Stealth Mode enables your automated browser sessions to mimic real user behavior across different sessions and IPs.
This guide shows you how to use these features responsibly.
Basic Stealth Mode focuses on solving what you can see — like visual CAPTCHAs and browser fingerprint clues that are commonly used to detect bots.
To make automation easier and more effective out-of-the-box, Browserbase automatically generates random browser fingerprints and viewports for each session. This avoids the need for manual configuration.
Browser fingerprint customization is no longer available for direct configuration to ensure better results and fewer detection issues. If you were previously using custom stealth configs, we’ve phased them out based on user feedback and performance metrics. Let us know if you have questions or need help transitioning.
Advanced Stealth Mode is only available for Scale Plan customers. Reach out to hello@browserbase.com if you’re interested in learning more, trialing the feature, or upgrading.
While Basic Stealth Mode automatically detects and solves most CAPTCHAs, Advanced Stealth Mode reduces the chances of being flagged as a bot by using a custom version of the Chrome browser, built and maintained by the Browserbase Stealth Team.
With Advanced Stealth Mode, we handle fingerprinting for you so any custom fingerprint configuration will have no effect.
Proxies are still very important for reliable browsing, and it’s recommended to enable them alongside Advanced Stealth Mode. Learn more about our proxy infrastructure and configuration options.
Please note, this feature is currently in beta; if you have any feedback, please reach out to support@browserbase.com.
Many websites use CAPTCHAs to distinguish between automated and human interactions, which can interrupt automation workflows. Browserbase provides integrated CAPTCHA solving to handle these challenges automatically, allowing your sessions to continue without manual intervention. CAPTCHA solving is enabled by default for Basic Stealth Mode and Advanced Stealth Mode.
How CAPTCHA Solving Works
If you’d like to disable captcha solving, you can set solveCaptchas to false in the browserSettings when creating a session.
Browserbase will emit a console log when a CAPTCHA is detected and being solved. You can listen to these events to wait until solving is complete before continuing with your automation.
If you encounter a non-standard, or custom captcha provider, you need to specify the explicit selector for the captcha image and button itself.
For this custom captcha provider, you’ll need to specify two CSS selectors:
The selector for the captcha image element
Right-click on the captcha image and select 'Inspect' then pull the 'id' from the HTML source code of the image
The id in this example is c_turingtestpage_ctl00_maincontent_captcha1_CaptchaImage
The selector for the input field where the solution should be entered
Right-click on the input field and select 'Inspect' then pull the 'id' from the HTML source code of the input field
The id in this example is ctl00_MainContent_txtTuringText
Configure your browser settings with these selectors
CAPTCHA solving typically takes between 5 and 30 seconds.
If you’d like to disable captcha solving, you can set solveCaptchas
to false
in the browserSettings
when creating a session.
Follow these best practices to ensure stable, efficient, and responsible automation with Browserbase.
Before automating a website:
To maintain stability and avoid detection:
If you encounter CAPTCHAs:
By following these best practices and troubleshooting steps, you can improve automation reliability, minimize detection risks, and optimize performance with Browserbase.
Need help? Contact support@browserbase.com