> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CAPTCHA handling

> Use a supported manual or automatic CAPTCHA option, then confirm the expected page and data before expanding the run.

When a site shows a CAPTCHA, first identify the environment where it appeared. Octoparse provides manual handling in Browse Mode and a Local-run pause, show-browser, and resume workflow. It also provides automatic solving for Image CAPTCHA, reCAPTCHA V2, and reCAPTCHA V3. After verification, confirm that the expected page and data are returned.

## Choose the handling path

| Situation                       | Available path                                                          | Confirm after verification                               |
| ------------------------------- | ----------------------------------------------------------------------- | -------------------------------------------------------- |
| You are editing a task          | Use Browse Mode to complete the CAPTCHA manually                        | The editor can load the intended page and fields         |
| A Local run pauses at a CAPTCHA | Show the browser, complete the CAPTCHA, then resume                     | The run continues and returns valid sample rows          |
| Supported Image CAPTCHA         | Configure its image, answer field, submit action, and failure condition | The expected page is loaded                              |
| Supported reCAPTCHA V2 or V3    | Use the configured automatic path                                       | The target accepts the session and expected data appears |

## How automatic CAPTCHA solving works

Add a **Solve CAPTCHA** step in the task editor, then choose the CAPTCHA type. The step runs during Local and Cloud extraction. Octoparse obtains the information required by the selected type, requests a CAPTCHA result, and applies that result to the page. It does not guarantee that the website will accept the result or allow the task to continue.

| Type              | What you set up                                                                           | What Octoparse does                                                                                                                        |
| ----------------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Image CAPTCHA** | Select the CAPTCHA image, answer field, submit action, and a failure condition with XPath | Captures the selected image, obtains an answer, enters it, submits it, and checks the failure condition before another configured attempt. |
| **reCAPTCHA V2**  | Select the supported reCAPTCHA V2 option                                                  | Detects the site key on the page, including supported iframe cases, obtains a token, and supplies it to the page. No XPath is required.    |
| **reCAPTCHA V3**  | Select the supported reCAPTCHA V3 option                                                  | Detects the site key and page action, obtains a token, and supplies it to the page. No XPath is required.                                  |

For Image CAPTCHA, the failure condition is important: it tells the task that the entered answer was rejected. Set a maximum retry count before running the task. If the page still shows the CAPTCHA after the test, stop and review the task setup rather than increasing the run volume.

## What automatic solving does not replace

Automatic solving handles the CAPTCHA step. It does not keep a login session valid, choose a proxy or region, repair a changed workflow, or confirm that the extracted data is correct. After a successful-looking attempt, check the final page and several output rows.

## CAPTCHA pricing

Automatic CAPTCHA solving costs **\$1 per 1,000 attempts**. Each attempt is charged at this rate, whether it succeeds or fails. If a CAPTCHA needs two attempts, both attempts are charged. Octoparse does not use a separate CAPTCHA credit balance.

Check your account's available credits before starting a larger run. If there are no available credits, the task cannot continue automatic CAPTCHA solving. A CAPTCHA-related resource event confirms that an attempt occurred; the final page and sample data confirm whether the website accepted it.

## Test before scaling

Use a small test before increasing task volume. Check the final page, the CAPTCHA-related resource events, and several output rows. If the page remains unavailable or the returned data is not correct, review the CAPTCHA type, session, IP, and page state before trying again.