Find help for a specific problem
Start from what you see on your site, and find the tool that fixes it.
BotBlocker has many settings and add-ons. You do not need all of them, and you do not have to read the whole guide to fix one problem. Most site owners come to the guide with one question: a customer was blocked, bots attack the login page, or the site feels slow.
When a situation involves an add-on, its name is in brackets.
I just installed BotBlocker
Welcome! Start with Get started with BotBlocker, and use the Setup Wizard to apply good settings in a few clicks. Keep the Dashboard open to see the results. Come back to this page when you have a specific problem.
Visitors and traffic
A real visitor was blocked or asked for a check
Sometimes BotBlocker can think that a real person is a bot. Usually you can fix this with a small change:
- Bot detection signals explains why it happened. Each sign is only a clue, and BotBlocker looks at many clues together before it decides.
- Where protection applies lets trusted visitors, logged-in users, and your own site tools skip the checks.
- Browser checks helps when only some browsers, extensions, or privacy tools have problems.
- Network connection types helps when the visitors come from VPNs, offices, schools, or mobile networks.
A service, app, or monitor stopped working
Uptime monitors, payment providers, webhooks, and apps that use the REST API cannot pass a check. BotBlocker can show them a check page or block them for sending too many requests. Add their addresses to your allow list. See Services that must always get through.
Bots visit too often, or they keep coming back (Rate limiting and Behavioral Analysis)
Rate limiting is your first shield against visitors who are too fast. It counts the requests of each visitor during a short time. If a visitor goes over your limit, BotBlocker can ask for a check or block the visitor. This stops sudden floods of traffic, content copying (scraping), password guessing, and form spam.
Behavioral Analysis makes rate limiting smarter. It looks at how a visitor moves through your site: how fast, how many pages, and how regularly. It also remembers addresses that behaved badly. By default, it remembers a single address for seven days, and a shared network for less time. So when a bot comes back, even a week later, BotBlocker recognizes it immediately. You can change how long BotBlocker remembers.
Behavioral Analysis uses the same traffic counts as rate limiting, so rate limiting must be on. Start with rate limiting. Add Behavioral Analysis when you want BotBlocker to remember bad bots for longer.
I want BotBlocker to check visitors more strictly
The Protection overview explains how BotBlocker decides what to do with a visit. When the usual settings are not enough, Stricter checks turns on stronger checks against persistent bots. That page also tells you the cost: your site then depends more on outside services, and on browsers that behave normally.
I want to block someone myself
You do not have to wait for BotBlocker to find a problem. With a rule, you decide. Select who or what (an address, a page on your site, or a whole country) and what to do (allow, check, or block).
- IP lists and proxies: for lists of addresses.
- Country and ASN rules: when the unwanted visitors come from one country or one network provider.
- Trusted bots and AI crawlers: to keep good bots, such as search engines, allowed.
Comment spam keeps coming (AI Anti-Spam Comments)
Most spam comments advertise gambling, medicines, or bad links. The AI Anti-Spam Comments add-on sends each comment to an outside AI service, which sorts it as spam, suspicious, or OK. The obvious junk is handled for you.
The text of each comment goes to that service. Read AI Anti-Spam Comments and External services that receive data.
I want suspicious visitors to prove that they are human
Instead of blocking a doubtful visitor, BotBlocker can ask for a quick check. Most people pass it in a second.
- Verification overview: what your visitors see.
- Challenge modes: how hard the check is.
- Image challenge: the picture task, and how it works on small screens.
- reCAPTCHA, and the hCaptcha and Cloudflare Turnstile add-ons: let a well-known outside service do the check.
- Cookies and sessions: how long BotBlocker remembers a visitor who passed.
- Visitors arriving from app browsers: help for people who open your site from email or social media apps.
Visitors get stuck on the check page
Sometimes the check does not finish, and the visitor cannot get in. The usual cause is a second protection service in front of your site, such as your host's firewall, a CDN, or an anti-DDoS service. The two systems then get in each other's way.
DDoS and intermediary resilience keeps the check working through that service. The Advanced and recovery overview covers other special setups.
Site speed
My site is slow
Performance and storage explains how BotBlocker saves work, and Cache backends shows how to use the fast storage that your host already gives you.
My pages load things my site does not use (Speed Up)
WordPress adds small extras to every page: emoji scripts, embeds, feeds, and comment tools. Many sites do not need all of them, but they load on every visit anyway. The Speed Up add-on lets you turn off the extras that you do not need, so your pages get lighter and faster. Nothing changes until you turn something off. Read Speed Up.
Login and access
Bots attack my login page
All WordPress sites use the same login address, so bots try common passwords on millions of sites. BotBlocker counts failed logins and blocks the addresses that keep guessing.
- Account security overview: how the login protection works.
- Login brute-force protection: the limits for failed logins.
- Two-factor authentication: a second proof of identity, such as a code from your phone.
I want to hide or move my login page (Hide Admin)
The Hide Admin add-on changes your login address to one that you choose. You also decide what people see at the old address. Bots that scan for the usual address find nothing to attack.
Remember: a hidden login is not a stronger login. Keep the brute-force protection and two-factor authentication on. Read Hide Admin.
I cannot get into my own site
- You can still open the Dashboard? Pause protection with the switch on the Dashboard. Then fix the setting that blocked you.
- You cannot get in at all? Use your secret links. See Emergency recovery secrets. When the site is behaving badly helps with the next steps.
- You use early protection (Early Init or MU mode)? It runs before WordPress and has its own recovery step. Read Early phase and MU mode.
Extra protection
I want to make sure that my site is not infected (Malware Scanner)
The Malware Scanner add-on checks your site's files and database. It compares your WordPress files with the official versions. It also looks for hidden code and bad links in your plugins, themes, uploads, and database. A finding is a warning to check, not proof of an attack. Read Malware Scanner.
I want browsers to add more safety to my site (Security Headers)
Browsers can follow extra safety rules for your pages. For example, they can refuse to show your pages inside other sites, use only secure connections, and load scripts only from places that you trust. The Security Headers add-on turns these rules on, group by group. These rules do not stop bots, but they make your site harder to misuse. Read Security Headers.
Visitors see a "not secure" warning on my site (HTTPS Protocol)
This warning appears when a page, or part of a page, uses the old connection that is not encrypted. The HTTPS Protocol add-on sends all visitors to the secure address and fixes the small parts that cause the warning. Your security certificate must already work. Read HTTPS Protocol.
I want to stop bad visitors before they reach my site (Firewall Export)
The Firewall Export add-on turns your list of blocked addresses into a file for your server or firewall. The server then stops these addresses before they reach WordPress. The file is a copy of your list at that moment, so export it again after you block new addresses. Read Firewall Export.
I want to control the old WordPress back door (XML-RPC Tunnel)
WordPress has a second way in, next to the login page. Some older tools and apps use it. Attackers like it too, because one request through it can try thousands of passwords. The XML-RPC Tunnel add-on keeps it closed and lets in only the addresses that you trust. Read XML-RPC Tunnel.
Site maintenance
I want to see what my site does in the background (Cron Jobs Manager)
WordPress runs tasks on a schedule: update checks, cleanups, emails, and more. Some are slow, and some are left behind by plugins that you removed. The Cron Jobs Manager add-on shows all of them on one screen and lets you turn off the ones that you do not want. It does not change when tasks run. It only removes the ones that you turn off. Read Cron Jobs Manager.
Some files run on every page, but I cannot see them in Plugins (Forced Inclusions)
Some files load automatically, but they do not appear on the Plugins screen. Examples are must-use plugins and the object cache file. The Forced Inclusions add-on shows them in a clear list and lets you turn them off. Nothing on your site stays hidden from you. Read Files that run without showing up in Plugins.
I want to save my settings or clear old data
Tools lets you look at, export, and refresh the data that BotBlocker collects. Maintenance actions removes data that you do not need. Some deletions are permanent, so read the page before you delete anything. An export of your settings is also the fastest way to compare or restore your setup.
Privacy
My site needs a cookie notice (Cookie Alert)
The Cookie Alert add-on shows a small notice at the top or bottom of your pages. It has a short message, a link to your privacy policy, and an accept button. It tells visitors that your site uses cookies and remembers when they close the notice. Read Cookie Alert, and make sure that it agrees with Privacy and data.
What does BotBlocker keep about my visitors?
Privacy and data explains what BotBlocker records about a visit, where it keeps the data, for how long, and how to delete it. External services that receive data lists each outside service that BotBlocker can contact, what it sends, and when.
Reports and activity
I do not know why a visitor was blocked
The Monitoring and maintenance overview shows you how to look back at BotBlocker's decisions.
- Traffic and audit logs records each decision and each change made by an administrator.
- Log and reports shows what happened to a specific visitor.
- Notifications and reports can tell you about problems when you are not watching.
I want updates without logging in (Telegram Reports, Pusher Digest)
The Telegram Reports add-on sends your weekly summary to a Telegram chat. The Pusher Digest add-on sends it to a dashboard service. Both run on their own schedule and do not slow down your site. Read Telegram Reports, Pusher Digest, and Notifications and reports to learn what they send.
Services, hosting, and special setups
I want to connect BotBlocker to another service
The Services and infrastructure overview covers all connections to outside services.
- Cloud API gets a second opinion from a service that watches traffic on many sites.
- Payment callbacks makes sure that order confirmations from payment providers always get through.
- WordPress abilities and connectors gives automation tools a safe, controlled way into your site.
I want protection to start sooner (Early Init)
Usually WordPress loads before BotBlocker starts most of its checks. The Early Init add-on moves your address blocks, and country blocks if you turn them on, to the very front door, before WordPress loads. Blocked visitors are stopped immediately, and all other visitors continue to the full BotBlocker checks. Early Init has its own recovery step, so first read Early Init and Early phase and MU mode.
A developer or my host asked me to change how my site responds
The HTTP and site behavior overview collects the settings that control how your site answers browsers, apps, and search engines.
- Responses and API access: status codes, and access for code on other sites.
- Blocks and responses: what a blocked visitor gets.
- Search and referrer behavior: search engines and links from ad campaigns.
My host does not have something that BotBlocker needs
Hosting and compatibility lists what BotBlocker needs from your host: the correct software versions, a folder where it can save files, scheduled tasks, and access to the internet. It also tells you what to do when something is missing.
I have many sites in one WordPress installation
BotBlocker on WordPress Multisite tells you if one activation protects all your sites, and where each site keeps its security data.
Not sure what to change?
Then do not change anything. The current settings keep your site protected. Come back to this page when you have a specific problem, and change one thing at a time. If a real visitor has problems, start with A real visitor was blocked or asked for a check above.
Learn how BotBlocker works
These overviews explain how BotBlocker works before you change a setting:
- Protection overview: how BotBlocker decides what to do with a visit.
- Visitor verification overview: what visitors see when BotBlocker needs more proof.
- Account security overview: how BotBlocker protects your WordPress login.
- Services and infrastructure overview: how BotBlocker works with other services and WordPress features.
- Monitoring and maintenance overview: how to read activity, reports, and notifications.
- Performance and storage overview: how BotBlocker keeps your site fast.
- HTTP and site behavior overview: how BotBlocker changes how your site responds and appears in search.
- Advanced and recovery overview: special hosting setups, and how to get back into your site.
Working on the Settings page
The Settings page holds all core protection settings. The buttons at the top of the page stay visible while you scroll. With them, you save or cancel your changes, or you apply a complete protection level in one click.
Save and cancel
Your changes on the Settings page do nothing until you save them.
Save
Saves the changes on the page. Until you save, the top of the page shows Not saved!, and your site still uses the old values. When you save, the changes apply at once.
Reset
Cancels the changes that you did not save yet. The page shows your last saved settings again. It does not go back to the default settings. When you have no unsaved changes, the button is inactive.
Simple mode
The settings menu has a Simple mode switch. It keeps the tabs that most sites need: bot detection, connection types, browser checks, data logging, and advanced protection. The rest are hidden from the menu, and their saved values stay as they are.
Use it when the full menu gets in the way, or when another person on the site should see only the main protections. Turn it off to see every tab again. Simple mode changes the menu, not the protection.
Link straight to a setting
Every tab has its own address, and every setting can be opened from a link. The address bar takes a tab name in the hash and a setting key after &focus=, for example admin.php?page=bbcs_settings#general&focus=hits_per_user. BotBlocker then opens the right tab and scrolls to the field.
This helps when you write instructions for a colleague or a support ticket. Most fields also have a documentation button that opens the matching section of this guide.
One-click setup
One-click setup opens the One-Click Security Setup panel. There you apply a whole protection level with Apply now. A level changes a group of related settings together, so it replaces your own changes to those settings. It also turns protection on again, if it was paused. Export your settings on the Tools page first, so you can go back.
The levels are the same as in the Setup Wizard.
Balanced Protection
Marked Recommended. The default level with safe settings: it blocks simple bots and has almost no effect on real visitors. It does not deny visitors without Accept-Language, classic proxies, HTTP/1.0 clients, Cloudflare-origin traffic or ad-blocker users, and it allows payment-gateway callbacks when WooCommerce is active. Rate limiting asks for a check at 60 requests per minute and blocks at 120. It keeps FULL secure mode and turns off the cloud checks and the VPN and Tor rules. Your license stays active.
Medium Protection
Marked Standard. It sits between Balanced and Strong: fake-referrer, iframe, referrer and honeypot checks, with rate limiting at 40 requests per minute for a check and 80 for a block. Ad-blocker, anti-detect and Cloudflare-origin checks stay off, so privacy-minded visitors see fewer challenges. It keeps the cloud checks and the VPN and Tor rules off.
Strong Protection
Marked Strict. For sites under an active attack. It adds ad-blocker and anti-detect checks, Cloudflare-origin blocking and reverse-DNS anomaly detection. Rate limiting asks for a check at 30 requests per minute and blocks at 50. Keep an allowlist for APIs and clients without Accept-Language. Like Balanced, it turns off the cloud checks and the VPN and Tor rules. If you want them on, select Full Protection.
Strong API Protection
Marked API. The same rules as Strong, plus empty Accept-Language is allowed, the user list is hidden and your admin IP is not auto-allowlisted. Choose it when the site has an API, a monitoring service or an MCP/automation client. It keeps the cloud checks and the VPN and Tor rules off.
Full Protection
Marked PRO. The strongest permanent level. It turns on the cloud checks, VPN and Tor blocking, hosting-network blocking, and private-browsing checks, with stricter rate limits (a check at 20 and a block at 30 requests per minute). It needs an active PRO license. Without one, it shows Requires PRO.
Emergency Protection
Marked PRO. A temporary lockdown for an active attack. It repeats Full and tightens every limit: a check at 10 and a block at 20 requests per minute over 2 minutes, one-hour rate bans, 30- and 60-minute visitor bans, stricter login limits and server DDoS resilience. It also blocks VPN, Tor, hosting and private browsing. It needs an active PRO license. BotBlocker restores the previous protection settings after six hours; applying another preset or saving settings cancels that restore.
Guided Setup
Opens the Setup Wizard with Start wizard. Use it when you want to go through each choice with its live checks, not apply a level in one step.
Some settings on the Settings page have a PRO or Ultimate badge. You can change them only with the matching license. See Plans and licensing.
Add-ons
Some guides on this page are for add-ons. Add-ons are extra modules that you can add to BotBlocker when your site needs them. You install and turn on each add-on separately, and each one has its own settings panel. When you turn an add-on off, your site goes back to its usual behavior. The Add-ons overview lists all add-ons and tells you how to install, turn on, and remove them.