Troubleshooting
Behavioral Detection Causing False Positives
Reduce sensitivity
Lower the detection sensitivity in Settings → ScraperBlock → Behavioral Detection → Sensitivity.
Add to Allowlist
Add the affected IP ranges to the IP Allowlist.
Review the block log
Check the block log to identify which signal is triggering the false positive.
Honeypot Link Visible to Users
Check theme CSS
Check your theme CSS to ensure no global style is overriding display:none.
Inspect in DevTools
Inspect the injected <a> tag in browser DevTools to confirm inline CSS is applied.
Contact theme developer
Contact your theme developer to resolve CSS inheritance issues if the override cannot be found.
Geo Blocking Not Working
Check geolocation database
Confirm a MaxMind database or WooCommerce geolocation is configured and up to date.
Test with a VPN
Test with a VPN set to a blocked country and check the block log for the entry.
Verify country code format
Verify the country code is ISO 3166-1 alpha-2 (two uppercase letters, e.g., CN, RU).
Analytics Shows Zero Events After Enabling
Confirm the database table
Confirm the analytics database table was created: {prefix}scraperblock_analytics.
Clear caching and test
Clear any caching plugins and test with a known bot user-agent via curl.
Check caching layer timing
Verify your caching layer is not serving cached pages before ScraperBlock runs.