Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,25 @@ sidebar:

import { Render } from "~/components"

If you encounter issues when solving a challenge, try the following:
## Why am I in a challenge loop?

You may encounter a challenge loop where the challenge keeps reappearing without being solved. This can happen for several reasons:

- **Network issues**: Poor or unstable network connections can prevent the challenge from being completed.
- **Browser configuration**: Some browser settings or extensions may block the scripts needed to execute the challenge.
- **Unsupported browsers**: Using a browser that is not supported by Turnstile.
- **JavaScript disabled**: Turnstile relies on JavaScript to function properly.
- **Detection errors**: If Turnstile suspects bot-like behavior, you may encounter repeated challenges for verification.

:::note
If the issue persists, try switching to a different network or device to rule out environmental factors.

Make sure that your browser is updated to the latest version.
:::

## General troubleshooting steps

Follow the steps below to ensure that your environment is properly configured.

<Render file="troubleshooting-steps" />

Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ When an error code is marked with `***`, it means that the remaining numbers can

## Error code `300***` and `600***`

Error code family `300***` and `600***` (e.g. "`600010`: The generic_challenge_failure") is a response generated by the Turnstile in situations where a potential bot or unusual visitor behavior is detected.
Error code family `300***` and `600***` (e.g. "`600010: The generic_challenge_failure`") is a response generated by the Turnstile in situations where a potential bot or unusual visitor behavior is detected.

You can troubleshoot these error codes using the following recommendations:

Expand Down
32 changes: 16 additions & 16 deletions src/content/partials/turnstile/troubleshooting-steps.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -3,19 +3,19 @@

---

- Verify your browser compatibility: Ensure that the browser you are using is one of the supported browsers for Turnstile and the browser is up to date. Refer to [supported browsers](/waf/reference/cloudflare-challenges/#browser-support) for more information.
- Cloudflare challenges support all major browsers except Internet Explorer.
- Clear your browser cache and cookies: Refer to the guides below on how to clear your browser cache and cookies based on your preferred browser.
- [Google Chrome](https://support.google.com/accounts/answer/32050?hl=en\&co=GENIE.Platform%3DDesktop)
- [Mozilla Firefox](https://support.mozilla.org/kb/clear-cookies-and-site-data-firefox)
- Safari
- [Desktop](https://support.apple.com/guide/safari/manage-cookies-sfri11471/mac)
- [Mobile](https://support.apple.com/105082)
- [Microsoft Edge](https://support.microsoft.com/windows/manage-cookies-in-microsoft-edge-view-allow-block-delete-and-use-168dab11-0753-043d-7c16-ede5947fc64d)
- Disable all browser extensions: Browser extensions may hinder the challenge from being successfully executed. To resolve this issue, disable your extensions and reload the page.
- Ensure that JavaScript is enabled.
- Confirm that cookies are enabled.
- Try again in incognito or private mode.
- Test with another browser or device.
- Ensure that you are not behind a VPN or proxy.
- Try from a different network.
1. Verify your browser compatibility.
- Turnstile supports all major browsers, except Internet Explorer.
- Ensure your browser is up to date. For more information, refer to our [Supported browsers](/waf/reference/cloudflare-challenges/#supported-browsers).
2. Disable your browser extensions.
- Some browser extensions, such as ad blockers or privacy tools, may block the scripts Turnstile needs to operate.
- Temporarily disable all extensions and reload the page.
3. Enable JavaScript.
- Turnstile requires JavaScript to run. Ensure it is enabled in your browser settings. Refer to your browser’s documentation for instructions on enabling JavaScript.
4. Try Incognito or Private mode.
- Use your browser's incognito or private mode to rule out issues caused by extensions or cached data.
5. Test another browser or device.
- Switch to a different browser or device to see if the issue is specific to your current setup.
6. Avoid VPNs or proxies.
- Some virtual private networks (VPN) or proxies may interfere with Turnstile by masking your real IP address or modifying request headers. Disable them temporarily to test.
7. Switch to a different network.
- Your current network may have restrictions causing Turnstile challenges to fail. Try switching to another network, such as a mobile hotspot.
Loading