Skip to content

Commit 2d650a5

Browse files
widget
1 parent 57e88df commit 2d650a5

File tree

1 file changed

+27
-11
lines changed

1 file changed

+27
-11
lines changed

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

Lines changed: 27 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -20,49 +20,65 @@ Widgets can be implemented in normal, flexible, or compact sizes.
2020

2121
Refer to [widget sizes](/turnstile/get-started/client-side-rendering/#widget-size) for an example on how to configure flexible or compact mode.
2222

23-
## Managed (recommended)
23+
:::note[Offlabel]
24+
Enterprise customers have the ability to remove the Cloudflare branding and customize the Turnstile widget.
25+
:::
26+
27+
## Availability
28+
29+
Free users are limited to 10 widgets per account.
30+
31+
[Enterprise Bot Management](/bots/get-started/bm-subscription/) customers can increase this limit to any higher number through the widget limit entitlement.
32+
33+
:::note
34+
Only Enterprise Bot Management and Enterprise Turnstile customers can have this limit increased. Contact your account team to increase your widget limit.
35+
:::
36+
37+
## Widget types
38+
39+
### Managed (recommended)
2440

2541
This mode is fully managed by Cloudflare. It automatically chooses the appropriate action based on various signals and risk levels. Cloudflare will use the information from the visitor to decide if an interactive challenge should be used. Turnstile will only require interaction if a further check is necessary to verify that the visitor is human. When an interaction is required, the user will be prompted to check a box (no images or text to decipher). This managed mode is ideal for users who want a simple configuration without needing to fine-tune the behavior.
2642

27-
### Light mode
43+
#### Light mode
2844

2945
![Managed challenge](~/assets/images/turnstile/light-regular.png)
3046
![Verifying the challenge](~/assets/images/turnstile/light-verifying.png)
3147
![Successful managed challenge](~/assets/images/turnstile/light-success.png)
3248

33-
### Dark mode
49+
#### Dark mode
3450

3551
![Managed challenge](~/assets/images/turnstile/dark-regular.png)
3652
![Verifying the challenge](~/assets/images/turnstile/dark-verifying.png)
3753
![Successful managed challenge](~/assets/images/turnstile/dark-success.png)
3854

39-
## Compact mode
55+
### Compact mode
4056

4157
You can configure the Turnstile widget in compact mode, which functions in the same way as a Managed widget.
4258

43-
### Light mode
59+
#### Light mode
4460

4561
![Compact managed challenge](~/assets/images/turnstile/light-compact.png)
4662

47-
### Dark mode
63+
#### Dark mode
4864

4965
![Compact managed challenge](~/assets/images/turnstile/dark-compact.png)
5066

51-
## Non-Interactive
67+
### Non-Interactive
5268

5369
Visitors will see a widget with a loading bar while the browser challenges run. Unlike managed mode, visitors will never be required or prompted to interact with the widget. This mode is ideal for users who want to prioritize visitor experience and do not want to add any friction with a Turnstile interaction.
5470

55-
### Light mode
71+
#### Light mode
5672

5773
![Verifying the challenge](~/assets/images/turnstile/light-verifying.png)
5874
![Successful managed challenge](~/assets/images/turnstile/light-success.png)
5975

60-
### Dark mode
76+
#### Dark mode
6177

6278
![Verifying the challenge](~/assets/images/turnstile/dark-verifying.png)
6379
![Successful managed challenge](~/assets/images/turnstile/dark-success.png)
6480

65-
## Invisible
81+
### Invisible
6682

6783
This mode is similar to non-interactive mode where visitors will never interact with the Turnstile widget. Visitors will not see a widget or any indication that an invisible browser challenge is in progress. Invisible challenges should take a few seconds to complete.
6884

@@ -92,4 +108,4 @@ The widget expires when a token was issued but the user did not solve the challe
92108

93109
![Unsupported browser](~/assets/images/turnstile/unsupported-browser.png)
94110

95-
Visitors with outdated browsers or unsupported browsers will encouter this widget state. Refer to [Supported browsers](/waf/reference/cloudflare-challenges/#browser-support) for more information regarding supported browsers.
111+
Visitors with outdated browsers or unsupported browsers will encouter this widget state. Refer to [Supported browsers](/waf/reference/cloudflare-challenges/#browser-support) for more information regarding supported browsers.

0 commit comments

Comments
 (0)