logo
bars
///
Slider and Puzzle CAPTCHA: How They Work and How to Solve It
Kira Pridantseva
Kira Pridantseva
Technical Editor
November 20, 2026
8 min
Please review the terms of use for the materials on this website.

Slider and Puzzle CAPTCHA: How They Work and How to Solve It

A slider captcha asks you to move a handle along a track. A puzzle captcha gives you a piece to fit into a gap in an image. Some widgets combine the two, using the slider to move the piece into place. This guide explains where you’ll see each format and how they differ from click challenges. It also covers what the CapMonster Cloud API expects when you test your own forms.

robots
Get started now and automate your solution reCAPTCHA v2

Key Takeaways

  • You get past a slider by dragging the handle (or a puzzle piece) into the correct position, which the page then either accepts or rejects.
  • Slider and puzzle challenges work in a similar way, while click challenges ask the user to click characters, icons or parts of an image rather than drag.
  • GeeTest, DataDome, FengkongCloud, ARCaptcha, NetEase Yidun and Tencent all use drag or click challenges on their widgets.
  • The CapMonster Cloud slider captcha solver is based on two API calls: createTask for sending the page parameters and getTaskResult for receiving the solution.
  • FengkongCloud is handled as a CustomTask with the class fengkongcloud, while ARCaptcha uses its own task type called ArCaptchaTask.

What Is a Slider Captcha?

A slider captcha is a check where the user drags a handle or a puzzle piece into the right position before continuing. The widget shows a track with a handle, often next to a picture with a piece missing. Dragging the handle moves the piece across the picture. You let go when it lines up with the cutout, and the page either lets you continue or shows you a new challenge.

What it looks like varies from one vendor to the next. A simple slider captcha example is a bar with an arrow you move all the way to the right. Others are a picture with a shape removed from it and a matching puzzle piece on the left-hand side. You drag the handle, and the piece moves across until it fills the gap. Many have a brief instruction, such as "Drag to complete the puzzle", and a refresh icon to load a new image.

For someone signing up, logging in or checking out, a slider takes one quick swipe. That's a lot easier than typing out warped letters or clicking every image with a traffic light in it. Sites get a way to filter out bot traffic, and they tend to keep the widget for the steps that matter most, like registration or a password reset.

The widget provider determines what goes into your API request, so find out which one the site uses before setting up the test or automation. If you can't tell which one you're dealing with, this walkthrough on how to tell which captcha a site uses will help.

Slider vs Puzzle vs Click Captchas

Sliders, puzzles and click challenges each ask you for a different gesture. A slide puzzle captcha sits between the first two: you drag the handle, and the handle pushes the puzzle piece into the gap.

TypeWhat the user doesWhere it appearsHow it is solved via API
SliderDrags a handle along a track to a target pointGeeTest, DataDome, FengkongCloud, NetEase Yidun, TencentcreateTask with the provider's task type and page parameters, then getTaskResult returns the solution (for FengkongCloud, a token in solution.data.token)
Puzzle (fit the piece)Drags a puzzle piece into the matching gap in an imageGeeTest, DataDome, ARCaptcha, NetEase Yidun, TencentSame two-call flow (for ARCaptcha, the ArCaptchaTask type returns a token in solution.token)
Click / selectClicks icons, characters or image areas in the order a prompt givesGeeTest (icon selection), FengkongCloud, NetEase Yidun, TencentCheck the provider's task page for the variants it lists; the FengkongCloud page shows only a slider example

It's very difficult to draw a clean line between the first two rows. With a sliding puzzle captcha the piece moves with the handle, so one action covers both. On some sites the widget can switch from a slide to a puzzle to a click challenge on the same page, so a script written for one type of gesture won't be very durable. That's not an issue with token-based tasks such as FengkongCloud and ARCaptcha. Their required inputs are the page URL and the site key, not a picture of the challenge.

Slider Captcha Examples

Each slider captcha example below shows a different widget. The layout and instructions vary, as does what happens when you release the handle. Here are four you might encounter when testing your own forms.

GeeTest v4 uses a compact widget. In slide mode you drag the handle until a piece slots into the gap in the background image. Other modes include icon selection, Match-Three, Gobang and OneTap Pass. All the parameters and task setup are on the GeeTest v4 solver page.

DataDome can appear as a full-page interstitial or as an embedded frame with a sliding puzzle captcha: a background image, a puzzle piece and a slider beneath it. The DataDome solver page details how CapMonster Cloud deals with it.

The FengkongCloud widget can present a slider puzzle, a character selection or an icon selection task; the CapMonster Cloud docs use the slider as their example. The widget's scripts load from castatic.fengkongcloud.com, which makes the provider easy to spot in the Network tab.

ARCaptcha has three challenge types: Hidden (invisible), Puzzle and Classic. In Hidden mode you see nothing at all unless the widget asks for further verification. Puzzle mode shows a visible drag challenge.

How to Solve a Puzzle Captcha with an API

Learning how to solve puzzle captcha challenges through an API comes down to two calls: createTask and getTaskResult. A slider captcha solver or puzzle captcha solver does not drag anything in your browser. It receives the page parameters and returns a solution for your script to use.

createTask. Send a JSON POST to https://api.capmonster.cloud/createTask with your clientKey and a task object. A successful response has errorId 0 and a taskId.

getTaskResult. Send the clientKey and taskId to https://api.capmonster.cloud/getTaskResult. While status is processing, wait at least 2 seconds and ask again. When status is ready, the solution object holds the result, and its structure depends on the task type.

The documentation for each provider explains how to solve puzzle captcha challenges with its task type. Request fields and response formats vary. ARCaptcha returns a token, for example, and DataDome returns cookies.

Example ARCaptcha createTask request

{
  "clientKey": "API_KEY",
  "task": {
    "type": "ArCaptchaTask",
    "websiteURL": "https://example.com/",
    "websiteKey": "your-website-key",
    "isInvisible": false,
    "userAgent": "userAgentPlaceholder"
  }
}

Keep your real API key on the server side or in environment variables. Don't hard-code it in client-side scripts or commit it to a repository.

FengkongCloud Captcha

FengkongCloud is a captcha service designed to protect websites from automated activity. The Fengkong captcha can show a slider puzzle, ask visitors to select characters from a prompt, or have them click icons in an image. CapMonster Cloud’s task documentation shows the slider as its example.

You'll know a site runs the Fengkong captcha if it loads widget scripts from castatic.fengkongcloud.com and makes a /conf request. Both matter, because that's where the task values come from. Open Developer Tools, reload the page and find the /conf request. It carries the identifiers the widget was initialised with, and the FengkongCloud task documentation tells you which of them goes into websiteKey.

Task fieldValue or purpose
typeCustomTask
classfengkongcloud
websiteURLRequired. Address of the page with the captcha
websiteKeyRequired. Widget key taken from the page
metadata.apiJsUrlOptional URL of the widget script
userAgentOptional browser User-Agent

The FengkongCloud solver returns the token in solution.data.token when the task is ready. See the FengkongCloud captcha solver documentation for the task reference.

ARCaptcha

ARCaptcha is a privacy-focused tool for blocking automated activity with three modes. Hidden mode checks in the background and asks for extra verification only when it suspects a bot. Puzzle mode shows a visible drag-the-piece challenge. Classic is the third, traditional challenge format.

Search results and forum posts sometimes call it “AR captcha.” If you’re checking a page you maintain, look at the widget’s setup code to confirm the provider. The HTML widget may use the data-site-key attribute, and the React component uses the site-key prop. Depending on the integration, you may also see site_key or sitekey in the widget settings.

If you're running an ARCaptcha bypass as part of testing your own forms, here's what the task needs:

Task fieldValue or purpose
typeArCaptchaTask
websiteURLRequired. Address of the page with the captcha
websiteKeyRequired. The widget's site key
isInvisibleOptional flag for an invisible widget
userAgentOptional browser User-Agent

The first response, from createTask, contains the taskId. Keep polling getTaskResult with it until the task is ready, and then read the token from solution.token, which is also covered in the ARCaptcha solver documentation.

Other Chinese Captcha Providers

Tencent’s TCaptcha offers slider and click challenges. CapMonster Cloud covers both formats in its Tencent challenge guide. It also has a separate Yidun (NetEase) guide and an Alibaba captcha guide.

Errors and Tips

If a task fails, check the API error code first.

  • CAPTCHA_NOT_READY: the task is still being solved. Call getTaskResult again, at least 2 seconds after the previous request.
  • ERROR_TOO_MUCH_REQUESTS: the request limit has been exceeded. Increase the interval between requests. Each task allows up to 120 getTaskResult requests.
  • ERROR_NO_SUCH_CAPCHA_ID: the task does not exist, its result is no longer stored or the ID has the wrong format. Check that the task ID is correct. If the result has expired, create a new task.
  • ERROR_WRONG_USERAGENT: the request contains an invalid User-Agent. Use the current value from the CapMonster Cloud User-Agent endpoint instead of the userAgentPlaceholder from the examples.
  • ERROR_CAPTCHA_UNSOLVABLE: The service couldn’t solve the challenge. Check that the task parameters are correct and current before retrying.
  • ERROR_TASK_NOT_SUPPORTED: check the value of the type property.
robots
Get started now and automate your solution reCAPTCHA v2

FAQ

It's a drag-to-verify check. You pull a handle sideways, usually carrying a puzzle piece into a gap in an image, and the page lets you continue once the piece lines up. When you sign in or create an account, the check adds a single drag and helps the site screen out automated requests.

For a basic slider, you drag a handle along a track; in a picture puzzle, you match a piece to a gap in the image. A slide puzzle captcha lets you use the handle to move the piece, which means both names can refer to the same widget.

If you use a puzzle captcha solver to test your own site, choose the task type for the widget on your page. The task documentation lists the expected fields. When getTaskResult reports ready, look in solution. Its contents vary by task. ARCaptcha returns a token, for example, and DataDome returns cookies.

The FengkongCloud solver uses a dedicated task configuration for automated tests on your own site. The task type is CustomTask and the class is fengkongcloud. The task guide lists the required fields. When the task status is ready, the response contains the token in solution.data.token.

Create a task of type ArCaptchaTask with the websiteURL and the websiteKey taken from the widget's site key, and set isInvisible to true only for the hidden variant. Then poll getTaskResult with the returned taskId. The ARCaptcha solver returns the token in solution.token. Use this AR captcha workflow, like any ARCaptcha bypass, only on resources you are allowed to test.

The CapMonster Cloud task for DataDome requires a proxy. The FengkongCloud and ARCaptcha task guides don’t list a proxy requirement. If you’re working with another task, its guide will tell you whether a proxy is required and which settings the API accepts.

CapMonster Cloud’s user agreement permits testing your own site or a site whose owner has authorized the test. Before running a test, check the site’s terms and the laws that apply. If you’re unsure how those rules apply to your situation, ask a lawyer.

Conclusion

Whatever the visitor sees, a slider or a puzzle, solving it through the API starts with identifying the provider. For FengkongCloud, that means a CustomTask with the fengkongcloud class. For ARCaptcha, it's ArCaptchaTask, with isInvisible set to true only in hidden mode.

Get a CapMonster Cloud API key to start testing, and refer to the CapMonster Cloud API documentation for the parameters of each task.


NB: Please note that the product is intended for automating tests on your own websites and sites you have legal access to.
ItGuy
geear
Affiliate program for software developers
Earn up to 30% from your users’ spending on captcha bypass
✅ Request sent
Thank you for your interest in our partnership program! We will contact you within 7 working days.
Request to Join
Fill out the form to submit an application for the affiliate program.