Skip to content
Merged
Changes from 4 commits
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
23 changes: 9 additions & 14 deletions src/content/docs/turnstile/concepts/hostname-management.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,9 +10,12 @@ You can associate hostnames with your widget to control where it can be used usi

## Hostname limits

By default, all widgets can have up to 10 hostnames associated with a widget. A widget requires at least one hostname to be entered.
By default, a widget can have a maximum of 10 hostnames associated. Each widget requires at least one hostname to be entered.

Only Enterprise Bot Management and Enterprise Turnstile customers can have this limit increased. Contact your account team to increase your hostname limit.
:::caution[Availability]
Customers with Enterprise Bot Management or Enterprise Turnstile may create and use a widget without entering any hostnames, or have more than 10 hostnames associated with a widget.
Contact your account team for the feature access.
:::

## Add a custom hostname

Expand All @@ -33,6 +36,10 @@ If you already have a zone registered with Cloudflare, you can add hostnames dur

## Hostname requirements

:::caution
Customers enabling [client-side rendering](/turnstile/get-started/client-side-rendering/) must validate their hostnames by looking at the [`hostname`](/turnstile/get-started/server-side-validation/#:~:text=challenge%20was%20solved.-,hostname,-is%20the%20hostname) field in the siteverify response.
:::

When associating hostnames with a widget, follow these requirements:

- Hostnames must be fully qualified domain names (FQDNs), such as `example.com` or `subdomain.example.com`.
Expand All @@ -57,16 +64,4 @@ However, it will not work on the following hostnames:

:::note
If the widget is embedded on a hostname not listed, it will display an error message.
:::

## Optional hostname validation (Enterprise only)

Customers with Enterprise Bot Management or Enterprise Turnstile can have the optional `any hostname` validation entitlement.

By default, a widget requires at least one hostname to be entered. With this entitlement, you can create and use a widget without entering any hostnames for the widget.

Contact your account team to enable this entitlement.

:::caution
Customers enabling [client-side rendering](/turnstile/get-started/client-side-rendering/) must validate their hostnames by looking at the [`hostname`](/turnstile/get-started/server-side-validation/#:~:text=challenge%20was%20solved.-,hostname,-is%20the%20hostname) field in the siteverify response.
:::
Loading