Skip to content

Commit 078a53c

Browse files
turnstile widget mode table (#28064)
1 parent 6eb25e5 commit 078a53c

1 file changed

Lines changed: 13 additions & 7 deletions

File tree

src/content/docs/turnstile/concepts/widget.mdx

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,12 @@ Turnstile is hosted under `challenges.cloudflare.com`. Your application will con
1919

2020
The available modes for Turnstile widgets are **Managed**, **Non-Interactive**, and **Invisible**.
2121

22+
| Widget mode | Description | Use case |
23+
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
24+
| **Managed** (recommended) | Automatically chooses between non-interactive or checkbox challenge based on visitor risk level. No images or text to decipher. | Simple setup with adaptive security. Balances protection and user experience. |
25+
| **Non-Interactive** | Displays visible widget with loading spinner. Runs challenges without requiring visitor interaction. | Minimize friction while showing verification is occurring. |
26+
| **Invisible** | Runs challenges completely in the background with no visible widget or loading indicators. | Maximize visual experience with zero visible verification elements. |
27+
2228
### Managed mode (recommended)
2329

2430
Managed mode is fully managed by Cloudflare. It automatically chooses the appropriate action based on client-side signals and risk levels. Cloudflare uses the information from the visitor to decide if an interactive challenge should be used.
@@ -63,15 +69,15 @@ Refer to [Widget configurations](/turnstile/get-started/client-side-rendering/wi
6369

6470
```mermaid
6571
flowchart LR
66-
A[<b>Loading</b><br /><small>Widget is processing the challenge.</small> ] --> B[<b>Interaction*</b><br /><small>Visitor needs to check the box. <br />*Managed mode only.</small>]
72+
A[<b>Loading</b><br /><small>Widget is processing the challenge.</small> ] --> B[<b>Interaction*</b><br /><small>Visitor needs to check the box. <br />*Managed mode only.</small>]
6773
B --> C[<b>Success</b><br /><small>The Challenge was completed successfully.</small>]
6874
```
6975

7076
### Error states
7177

72-
| <div style="width:200px">Type</div> | Description |
73-
| ---- | ----------- |
74-
| Unknown error | When an unknown error occurs during the challenge, visitors will encounter this widget state. Visitors can follow the troubleshooting guidelines from the widget or refresh the page to retry the challenge. |
75-
| Interaction timed out | When the visitor is presented with a checkbox but does not interact with it for an extended period of time. The challenge must be reissued by reloading the page or the widget. |
76-
| Challenge timed out | When the verification was completed but no further action has been taken, the challenge outcome will no longer be valid. For example, if a Turnstile widget is on a login page and the Turnstile successfully ran, but the visitor did not log in for an extended period of time, the challenge must be reissued by reloading the page or the widget. |
77-
| Outdated or unsupported browser | Visitors with outdated browsers or unsupported browsers will encounter this widget state. Refer to [Supported browsers](/cloudflare-challenges/reference/supported-browsers/) for more information regarding supported browsers. |
78+
| <div style="width:200px">Type</div> | Description |
79+
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
80+
| Unknown error | When an unknown error occurs during the challenge, visitors will encounter this widget state. Visitors can follow the troubleshooting guidelines from the widget or refresh the page to retry the challenge. |
81+
| Interaction timed out | When the visitor is presented with a checkbox but does not interact with it for an extended period of time. The challenge must be reissued by reloading the page or the widget. |
82+
| Challenge timed out | When the verification was completed but no further action has been taken, the challenge outcome will no longer be valid. For example, if a Turnstile widget is on a login page and the Turnstile successfully ran, but the visitor did not log in for an extended period of time, the challenge must be reissued by reloading the page or the widget. |
83+
| Outdated or unsupported browser | Visitors with outdated browsers or unsupported browsers will encounter this widget state. Refer to [Supported browsers](/cloudflare-challenges/reference/supported-browsers/) for more information regarding supported browsers. |

0 commit comments

Comments
 (0)