Skip to content

Captcha Authentication

Use this page when your login form contains a simple text-based captcha that must be solved before the form can be submitted.

Advanced captcha systems such as reCAPTCHA, hCaptcha, and Cloudflare Turnstile aren't solved automatically. For those systems, configure IP allowlisting for Escape's Public Locations. See Firewall Configuration.

How It Works

The solve_captcha browser action captures the page, reads the captcha text with AI vision, and fills the extracted text into the input field selected by locator.

Submit the form with a later click action, or set auto_submit: true.

Browser Actions Example

presets:
  - type: browser_actions
    login_url: https://example.com/login
    users:
      - username: user@example.com
        actions:
          - action: fill
            locator: input[name="username"]
            value: user@example.com
          - action: fill
            locator: input[name="password"]
            value: password123
          - action: solve_captcha
            locator: input[name="captcha"]
            auto_submit: false
          - action: click
            locator: button[type="submit"]

Action Reference

Property Type Required Default Description
action solve_captcha yes solve_captcha Action identifier
locator string yes Playwright locator of the input field
auto_submit boolean no false Submit the form automatically after the captcha is filled
allow_failure boolean no false Allow this action to fail without breaking authentication