Security · Guide
How to Put Wordfence in Learning Mode (Step by Step)

Short answer
Go to Wordfence, open Firewall, then the full firewall options. Under Basic Firewall Options, set Web Application Firewall Status to Learning Mode and save. Use the blocked features, review the allowlist, then switch back to Enabled and Protecting.
Key takeaways
- Learning mode allowlists normal traffic instead of blocking it.
- The setting lives in Basic Firewall Options under firewall status.
- Use the site's blocked features while learning mode is on.
- Review Allowlisted URLs and delete anything you do not recognise.
- Keep the learning period short, then re-enable protection.
- Allowlisting a single request is often safer than full learning mode.
How do you put Wordfence in learning mode?
Go to Wordfence > Firewall, open the firewall options, and change Web Application Firewall Status to Learning Mode, then save your changes.
Learning mode tells the Wordfence firewall to watch normal traffic on your site and add it to an allowlist instead of blocking it. It helps when the firewall flags legitimate actions as attacks.
Wordfence also starts in learning mode by default for about a week after you install it. During that time it learns how your site normally behaves.
This guide shows exactly where the setting lives, when to use it, how long to leave it on, and how to switch back to full protection safely.
What does Wordfence learning mode do?
In learning mode, the Wordfence firewall records requests that would normally match its rules and allowlists them, so legitimate site actions stop triggering false blocks.
The Wordfence learning mode documentation explains that the feature exists to avoid false positives on sites with unusual plugins, themes or admin workflows.
Think of it as a training period. While it is on, you use the site normally: save posts, submit forms, run page builders and import products. Wordfence notes what those actions look like and treats them as safe afterwards.
The firewall rules do not block those matched requests while learning mode is active. That is why you should keep the period short and do it when you control the traffic.
When should you use learning mode?
Use learning mode after installing a plugin or theme that triggers false blocks, after a big site change, or when admin actions keep getting blocked by the firewall.
Common situations include:
- A page builder save or form submission returns a 403 Forbidden or a Wordfence block page.
- You added a plugin that posts unusual data, such as code snippets, HTML or JSON.
- You moved the site to a new host or changed the server setup.
- You rebuilt the site and Wordfence keeps flagging your own admin work.
If Wordfence is blocking your own login rather than normal admin actions, our guide on fixing Wordfence blocking the admin covers other causes, such as rate limits and IP blocks.
Learning mode is not the right fix for a real attack. If Live Traffic shows unknown visitors probing your site, keep the firewall enabled and protecting.
Step 1: How do you open the firewall options?
In your WordPress dashboard, go to Wordfence > Firewall, then click the link to manage the firewall or view all firewall options.
The exact label can change between versions, but the firewall page always links to the full list of options. The firewall options guide describes each section.
You need an administrator account to change these settings. If you do not see the Wordfence menu, check that the plugin is active under Plugins.
Step 2: How do you switch the status to learning mode?
In the Basic Firewall Options section, open the Web Application Firewall Status dropdown, choose Learning Mode, and click Save Changes.
The dropdown has three choices:
| Status | What it does | When to use it |
|---|---|---|
| Enabled and Protecting | Blocks requests that match firewall rules | Normal everyday setting |
| Learning Mode | Allowlists matched requests instead of blocking | Short training periods to fix false positives |
| Disabled | Firewall rules do not run | Only for brief troubleshooting |
When you pick Learning Mode, Wordfence shows an option to switch back to protection automatically on a set date. Pick a date a few days away, or a week at most.
Click Save Changes at the top of the page. The status banner on the firewall page should now say the firewall is in learning mode.
Step 3: How do you train the firewall?
Use every part of the site that was being blocked, as an administrator, so Wordfence sees and allowlists those legitimate requests.
Work through your normal tasks deliberately:
- Edit and save pages in your editor or page builder.
- Submit each contact, checkout or booking form.
- Run any import or export tools you use.
- Save settings in plugins that were causing blocks.
- Log in and out as a normal user if members or customers were affected.
Do this while logged in from your usual location. The aim is to show the firewall your real traffic, not to wait for random visitors.
Step 4: How do you check what was allowlisted?
Open the Advanced Firewall Options section and review the Allowlisted URLs list, which shows entries added during learning mode.
Each entry lists a URL and parameter that the firewall will now ignore for its rules. Wordfence labels where each entry came from, so you can tell learned entries from ones you added by hand.
Scan the list for anything odd. If you see a URL you do not recognise, delete that entry. An allowlist built from attack traffic would weaken your protection.
Step 5: How do you turn full protection back on?
Change Web Application Firewall Status back to Enabled and Protecting and save, or let the automatic date switch it for you.
Do not leave the firewall in learning mode longer than you need. Once your blocked actions work, switch it back.
After re-enabling, repeat the actions that used to fail. If they now work, the allowlist did its job. If one still fails, check Wordfence > Tools > Live Traffic to see which rule blocked it.
How long should learning mode stay on?
Keep learning mode on for as short a time as possible, usually a few hours to a week, and only while you can watch your site's traffic.
The firewall's rule-based protection is relaxed during this period. Bots that hit your site at the same time could have their requests allowlisted too.
A short, focused session is safer than a week of passive learning. Turn it on, run your tasks, check the allowlist, and switch it back.
For more context on how firewalls protect WordPress, see our explainer on what a web application firewall is. The OWASP page on web application firewalls gives a wider view.
Are there safer alternatives to learning mode?
Yes. You can allowlist one specific blocked request from Live Traffic, or add a single URL and parameter to the allowlist by hand, without relaxing the whole firewall.
When Wordfence blocks a legitimate request, Live Traffic often shows an option to allowlist that action. This targets just the one rule match.
You can also add entries manually in Allowlisted URLs. Enter the URL path, the parameter type and the parameter name. This is the most precise fix when you already know what is being blocked.
Use full learning mode only when there are many false positives across the site and fixing them one by one would take too long.
How does learning mode fit your wider Wordfence setup?
Learning mode is one small part of Wordfence's firewall; most sites also benefit from extended protection, login security and regular scans.
If you have not optimised the firewall yet, our guide on setting up the Wordfence firewall walks through extended protection, which loads the firewall before WordPress itself.
For a full tour of the other options, see Wordfence settings explained. The free plugin is listed in the WordPress plugin directory.
Security plugins work best alongside basic hardening. The WordPress hardening guide covers file permissions, updates and other steps no plugin can replace.
What if learning mode does not fix the block?
If actions are still blocked after learning mode, the cause is probably not a firewall rule but an IP block, rate limit, login security setting or server-level firewall.
Check these in order:
- Wordfence > Firewall > Blocking for manual or country blocks on your IP.
- Rate limiting settings if you were blocked after many quick requests.
- Login Security if two-factor or reCAPTCHA is failing. Our guide on Wordfence 2FA not working can help.
- Your host's server firewall, such as ModSecurity, which runs outside WordPress.
If none of those apply, the Wordfence support forum on WordPress.org is a good place to ask, with your Live Traffic details ready.
Frequently asked questions
Does Wordfence learning mode leave my site unprotected?
The firewall rules allowlist matching requests instead of blocking them while learning mode is on, so rule-based protection is relaxed. Other features such as login security and scans keep working. Keep the period short and switch back to protecting as soon as you finish.
How long does Wordfence stay in learning mode after install?
New Wordfence installs start the firewall in learning mode for about a week by default, then switch to protecting automatically. You can change the date or switch to protecting early from the firewall options page.
Where do I see what Wordfence learned?
Open the firewall options and look at the Allowlisted URLs section under Advanced Firewall Options. Entries added during learning mode are labelled by source, so you can tell them apart from entries you added yourself.
Can I put only one rule in learning mode?
Learning mode applies to the whole firewall, not single rules. To fix one false positive, allowlist that specific request from Live Traffic or add its URL and parameter to the allowlist by hand instead.
Is learning mode available in the free version of Wordfence?
Yes. Learning mode is part of the firewall in both the free and paid versions. The paid versions mainly add real-time firewall rule updates and the IP blocklist, not extra learning mode features.
Sources
- Firewall Learning Mode Wordfence
- Firewall Options Wordfence
- Wordfence Security WordPress.org
- Web Application Firewall OWASP
- Hardening WordPress WordPress Developer Resources
Is your product missing, or something out of date?
Tell us what to add or correct. We read every note and reply when we need a source. A message does not buy a ranking.
Thanks — we review requests within 3 business days.
Related guides
About the editors
Researched from the primary sources listed above and checked against our editorial rules before publishing.


