Firewall Options

Change Firewall Mode (Enabled/Learning Mode/Disabled), Optimize the Firewall and configure advanced options.

Basic Options

Firewall Mode

The Wordfence Firewall can be either “Enabled and protecting”, in “Learning mode” or “Disabled”. When you first install Wordfence, the Firewall will be in “Learning mode” for one week. During this time you will not have full protection from the Firewall. The Firewall will instead during this time be learning how your system works in order to minimize “false positives”. A false positive is when something gets blocked that you did not want to block. If you have recently cleaned your site from a hack, or if you are under attack, you can choose to set the Firewall to “Enabled and protecting” instantly after installing Wordfence. The modes of the Firewall are:

Enabled and Protecting In this mode, the Wordfence Web Application Firewall is actively blocking requests matching known attack patterns, and is actively protecting your site from attackers.
Learning Mode In this mode, the Wordfence Web Application Firewall is whitelisting any requests that would normally be blocked by the firewall. Some requests contain data that may match patterns the firewall uses to detect attacks (such as an article about SQL injection that contains SQL code). While in Learning Mode, these requests will be whitelisted, excluding them from tripping the same rules once the firewall is enabled. Use this mode to prevent false positives on your site. [More about Learning Mode]
Disabled In this mode, the Wordfence Web Application Firewall is functionally turned off and does not run any of its rules or analyze the request in any way.

Protection Level

The Firewall can have Basic or Extended protection. If the Firewall has been Optimized, it will provide an extra layer of security and also improve Firewall performance. Learn how to optimize the Firewall.

Real-Time IP Blacklist

Wordfence monitors millions of attacks on WordPress sites every hour. This data is used to automatically generate a list of IP-addresses that are currently involved in bad behavior. The premium only IP Blacklist prevents known attackers from accessing your site. All this happens automatically, without you having to take any action. The IPs are blocked by the Web Application Firewall, so if your site has been set up with the firewall’s “Extended Protection,” this traffic is blocked before WordPress begins loading. The IP Blacklist is a premium feature and has no effect when using the free version of Wordfence. Learn more about the IP Blacklist.

Advanced Options

Delay IP and Country blocking until after WordPress and plugins have loaded

When the Wordfence Firewall is optimized, the Firewall loads before the WordPress environment loads. This is desired behavior, as it increases security and gives the Firewall a performance boost. But if your server has a conflict with blocking by IP, country, or other advanced blocking settings before WordPress has loaded, you can turn on this option to allow WordPress to load first. We do not recommend enabling this option except for testing purposes.

Whitelisted IP addresses that bypass all rules

If you have a static IP address in an office or on a permanent Internet connection and you want to configure Wordfence to always allow that IP address to bypass any rules, then you can enable this option.

Please note that this feature is often misunderstood, and we have site admins who try to whitelist their home IP address on a broadband connection. Your broadband IP address is not a permanent IP address because it is dynamically assigned and will change after several weeks or months – or sometimes over a shorter period. So we don’t recommend you try whitelisting your home Internet connection’s IP address if you’re using ADSL or cable modem because your IP will inevitably change after a time, making this whitelisting ineffective and potentially causing whoever is assigned the IP address after you lose it to have unlimited access to your website. Only use this feature if you are sure you have a permanent IP address. Most people don’t.

You can whitelist whole networks if needed (Bing, for example). To enter these, you need to input them in the[x-x] format. This page can help you translate CIDR formats to ranges – Examples:

  • would be entered as 65.52.104.[0-255]
  • The IPv6 range 2a03:2880:f001::/48 would be entered as 2a03:2880:f001:[0-ffff]:[0-ffff]:[0-ffff]:[0-ffff]:[0-ffff]

Immediately block IPs that access these URLs

This allows you to set a trap for bad guys. You can enter a URL that does not exist, for example: /vulnerabilityLivesHere

If anyonee tries to access that URL, they are instantly blocked. You have to specify a relative URL. In other words, it must start with a forward slash. Wildcards (*) can be used, if there are visits to multiple bad URLs. For example, if there are visits to /badpage-one/ and /badpage-two/, then entering /badpage-*/ will block both.

We only recommend this feature if you are trying to catch a specific hacker to block them, or if you are trying to catch hackers that are trying to exploit a known vulnerability or page on your site. Be careful not to visit the banned URL yourself by accident, as you will be blocked instantly.

When blocked via this option, an IP will be blocked for the duration you have specified under “Rate Limiting Rules.”

Ignored IP addresses for Wordfence Web Application Firewall alerting

If you are regularly running a scanning, uptime, or other bot-like service against your site and you do not want to be alerted about an increased attack rate, you can enter the IP of that service here. Make sure that you trust the service, since you will not receive any alerts if the IP attacks you.


The Wordfence Web Application Firewall has a number of rules that match known attacks, i.e. attacks commonly seen and exploited in the wild. The patterns for these attacks are specific and require minimal processing in determining if the request matches. The WAF also uses a number of generic rules that use pattern matching to determine if the request looks malicious. These are designed to prevent 0-days for known types of attacks from being exploited.

If you are having problems with false positive blocks (legitimate visitors are blocked from performing a specific action), individual Firewall Rules can be disabled for testing purposes. You can use Wordfence Live Traffic to figure out which Firewall rule that caused a specific block.

At the bottom of this section there is a button that allows you to manually refresh Firewall rules. Firewall rules are automatically updated on your site but you may on occasion be prompted by Wordfence support to manually refresh them.

Brute Force Protection

Brute Force Protection prevents attempts to guess username and password aimed at gaining access to your WordPress admin. Wordfence provides an option to limit login attempts and several other features that secure your login. Brute force protection is enabled by default, but you can optimize the individual options. See the full list of Brute Force Options.

Rate Limiting

Rate Limiting makes it more difficult for attackers to perform unauthorized scanning and scraping of your site. Rate Limiting options come with a default set of values that you can customize. See the full list of Rate Limiting Options.

Whitelisted URLs

The Firewall Whitelist is part of the Learning Mode feature of Wordfence, which lets the Firewall learn to not block safe requests even if the Firewall considers them to appear suspicious. You can read more about the whitelist and Learning Mode here.

Monitor Background Requests for False Positives

Within the WordPress environment, some requests are made via AJAX (asynchronous JavaScript and XML). Such requests do not involve loading a new page, but instead perform various tasks in the background. The Wordfence Firewall can block background requests that use AJAX, showing a message that says “Background Request Blocked.”

This can prevent certain types of attacks, but some plugins and themes may trigger this message as well, even if their requests are safe. It is most likely to occur when adding custom HTML or JavaScript code in fields that are separate from the WordPress core. As the admin of the site, you can choose to whitelist these blocked requests by clicking the Whitelist button, if you were simply working on the site when they occur. This message is only shown for logged-in admins of the site, so regular visitors, subscribers, authors, editors, or other types of users on your site will not see them.

If you see this message when clicking a link that was sent to you by another person, or a link from another site that leads to your site, it may not be safe to whitelist. You can contact us about blocked requests if you are not sure whether they are dangerous. Be sure to include a description of what you were working on at the time.

Wordfence loads a script for logged-in admins that watches for background requests that get blocked by the firewall, to alert if you if something was blocked that might not need to be blocked. The option “Monitor Background Requests for False Positives” allows you to disable this script if you like, by unchecking either or both boxes, for the front end of the site or for the wp-admin section of the site. Disabling the monitoring script does not affect the firewall’s protection, but may make it harder to notice false positives (blocking actions that are not actually malicious).