​
Overview

reCAPTCHA is Google’s bot detection system that presents challenges to verify human users. When Stably encounters reCAPTCHA during automated testing, it can block test execution. This often during the login or signup flow.

​
Solutions

There are a number of solutions to work around this that might fit your needs

​
Solution 1: Disable for testing

If you have non-production deployments, such as staging or preview deployments, these are ideal for testing. The easiest solution in these cases is to simply have your dev team disable reCAPTCHA for these environments

​
Solution 2: IP Allowlisting

If you need to test against production or cannot disable reCAPTCHA in your staging/development environment, you can allowlist Stably’s IP addresses. For the list of IPs, see our Stably IP Allowlist documentation. There are two main ways to implement this:

​
IP Allowlisting: reCAPTCHA Enterprise

If you are on reCAPTCHA’s enterprise plan, you can follow their instructions using our Stably IP Allowlist

​
IP Allowlisting: reCAPTCHA Enterprise

If you do not have reCAPTCHA Enterprise then you can instead implement allowlisting yourself in code. The implementation will of course differ, but it will look something like: 
const allowlistedIPs = ['44.227.156.59', '44.226.77.61'];
const clientIP = (req.headers['x-forwarded-for'] || req.connection.remoteAddress || '').split(',')[0].trim();

if (allowlistedIPs.includes(clientIP)) {
  // Skip reCAPTCHA validation
} else {
  // Proceed with reCAPTCHA validation
}
For the latest allow list, please see our Stably IP Allowlist