Configure bot detection
Shield's Bot Detection spots automated traffic — scrapers, credential stuffers, and other non-human clients — and either logs it or challenges it before it reaches your site. It scores each visitor using several signals (request integrity, IP reputation, and browser fingerprinting) and you control how sensitive each signal is. This guide covers turning it on and tuning it from the site dashboard.
Bot Detection is a premium Shield feature
Unlike the WAF, Bot Detection is only available on the premium Shield tier. On a plan with the base Shield tier, the Bot Detection page shows a "Bot Detection requires a higher plan" card with an Upgrade plan button instead of the settings form.
Before you start
- A site with Shield included in its plan, on the premium tier.
- Shield must be activated for the site. If it hasn't been, the page shows a "Shield isn't active for this site" message with an Activate Shield button — activate it first.
Open the Bot Detection page
-
Open your site, then in the left sidebar choose Shield.
-
Select the Bot Detection tab. Shield's sub-navigation runs across the top: Overview, WAF, Bot Detection, Rate Limits, Access Lists, and Security Events. Choose Bot Detection.
The page loads the current settings live and shows a Bot Detection Settings card.
Choose an execution mode
At the top of the card, Execution Mode is a two-option control:
- Log only — records bot detections without blocking anything.
- Challenge — presents suspected bots with a browser verification challenge.
Tip
Start in Log only, watch the Security Events log to see what would be challenged, then switch to Challenge once you're confident legitimate visitors aren't being caught. Higher sensitivity catches more bots but can also challenge legitimate visitors, so raise it gradually.
Tune the detection sensitivity
Below the execution mode are four detection controls. The first three are sensitivity levels — each is a dropdown with Off, Low, Medium, and High:
- Request Integrity Sensitivity — how strictly the request itself is checked for signs of automation.
- IP Address Sensitivity — how heavily a visitor's IP reputation is weighted.
- Browser Fingerprint Sensitivity — how strictly the visitor's browser fingerprint is scored.
The fourth control, Browser Fingerprint Aggression, is a dropdown with Unknown, Low, Medium, High, and Custom. It controls how aggressively the fingerprint check acts on a borderline visitor — higher settings lean toward challenging when the signals are inconclusive.
Enable complex browser fingerprinting (optional)
The Enable complex browser fingerprinting switch turns on additional browser signals for fingerprinting. It can improve detection; leave it off unless you need the extra accuracy.
Save your changes
Click Save settings to apply your configuration, or Cancel to discard unsaved changes and reload the current settings. A confirmation message appears once the update succeeds.
After saving, you'll see "Bot detection settings have been updated." If the save fails, the page reloads with the settings unchanged and shows the reason.
To manage bot detection through the API, see the Shield API reference.
Next steps
- Review challenged and logged traffic in the Security Events log
- Tune the WAF and its rules for request-level protection
- Add rate limits and access lists for further control
- Read the full Shield API reference