You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/content/docs/turnstile/concepts/widget.mdx
+27-11Lines changed: 27 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,49 +20,65 @@ Widgets can be implemented in normal, flexible, or compact sizes.
20
20
21
21
Refer to [widget sizes](/turnstile/get-started/client-side-rendering/#widget-size) for an example on how to configure flexible or compact mode.
22
22
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)
24
40
25
41
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.
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.
54
70
55
-
### Light mode
71
+
####Light mode
56
72
57
73

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.
68
84
@@ -92,4 +108,4 @@ The widget expires when a token was issued but the user did not solve the challe
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