Vercel’s deployment protection can block Stably’s automated testing by requiring authentication or presenting challenge pages. This guide shows you how to configure your Vercel deployment to allow automated testing.

​
What is Vercel Deployment Protection?

Vercel deployment protection helps secure your preview deployments by requiring authentication before users can access them. However, this can interfere with automated testing tools like Stably.

​
Solutions

Vercel provides specific methods to bypass deployment protection for automation tools. You can configure bypass rules that allow automated testing while maintaining security for human users. Follow Vercel’s official documentation for setting up protection bypass for automation: Vercel Protection Bypass for Automation

​
1. Custom Headers

You can configure Vercel to bypass protection when specific headers are present. In Stably:
  1. Go to Browser Settings in your project configuration
  2. Add a custom header as specified in your Vercel bypass configuration (usually x-vercel-protection-bypass)
  3. Run your tests to verify the bypass works

​
2. IP Allowlisting

If your Vercel configuration supports IP allowlisting, you can add Stably’s IP addresses to your allowlist. See our IP allowlist guide for the current IP ranges.

​
Testing Your Configuration

After configuring the bypass:
  1. Run a simple test against your protected Vercel deployment
  2. Verify that Stably can access the application without encountering protection screens
  3. Check that protection still works for regular browser access

​
Need Help?

If you’re still experiencing issues with Vercel deployment protection, please reach out to our support team with:
  • Your Vercel deployment configuration
  • The specific error messages you’re seeing
  • Screenshots of any protection screens encountered during testing