Troubleshooting and FAQUpdated
Most problems come down to a missing token permission, a rule blocking a service you use, or WP-Cron not running. Find your problem below.
Connection and permissions#
Zones don’t load, or I see “Cloudflare rejected your credentials”. The token is wrong, expired or revoked. Create a new token (see Connecting to Cloudflare), then edit the account on the WAF Rules screen and paste it. Click Test Connection in Settings to check.
Zones load, but some are missing. The token’s Zone Resources don’t include them, or they belong to another Cloudflare account. Edit the token to include all zones, or add another account. Only zones with Cloudflare status Active are listed.
A screen says “Your API token is missing a permission”. The message names the permission. Edit the token in Cloudflare, add that permission and save. There’s no need to paste the token again. The full list is in Connecting to Cloudflare.
My saved accounts disappeared. Either the account was saved with a Keep for time that ran out, or the site’s AUTH_KEY in wp-config.php changed (for example after a migration), so the encrypted credentials can’t be read. Add the account again.
Updates and installation#
After an update the plugin is deactivated with “Plugin file does not exist”, or two copies are listed. This happens when updating from 1.0.23 or earlier and the plugin’s folder isn’t named wpwafmanager. Your settings are still in the database. Deactivate any active copy, upload the latest zip in Plugins → Add New → Upload Plugin and activate it, then delete the leftover copy. From 1.0.24.1 on, updates always stay in your current folder and deleting a spare copy keeps your settings. See Installation and Updates.
A notice says two copies are active, or another copy is installed. Delete the copy named in the notice from the Plugins screen. Your settings are shared and stay in place.
Pro updates don’t appear. Check the license shows as activated on WAF Manager → License, then open Dashboard → Updates to check straight away.
License activation fails. “This is not a valid license” means the key was mistyped. “This license is not valid for this product” means it belongs to another product. If the plugin folder isn’t named wpwafmanager, rename it (deactivate first) and try again.
WAF rules#
Deploy fails with “This zone also has N other custom rule(s)”. The zone’s plan doesn’t allow that many custom rules. The Free plan allows five, and the plugin uses all five. Delete rules you don’t need in Cloudflare, or deploy again with Replace all custom rules in the zone ticked. Check the Zone Rules tab first: Replace all deletes every rule there that the plugin didn’t create. See Deploying Rules to Your Sites.
My own custom rules are gone after deploying. Deploys keep your other custom rules unless Replace all custom rules in the zone was ticked. If it was, recreate the rules in Cloudflare, or add an allow rule’s expression to Custom Allow Expressions in Rule 1. Versions before 1.0.25 replaced every custom rule on each deploy.
A backup, monitor, webhook or app stopped working after deploying. Open Security Events (Pro zones) or Cloudflare Security → Analytics → Events and find the blocked request. Turn on the service under Services with a Published IP List in Rule 1, or add its IP under Your server IPs, save and deploy again. If the service runs on a host Rule 3 blocks, such as Hetzner, this is the usual cause. On Free zones, also check Bot Fight Mode in Bot Control: custom rules can’t skip it.
An API or app host gets 403 errors for curl requests. Rule 2 blocks curl user agents by default. Add the hostname under Except these hostnames in Rule 2, or turn off Block curl user agents, and deploy again.
The deploy says a rule is too long. A rule is over Cloudflare’s 4,096-character limit, so nothing was sent. The Expressions tab shows each rule’s length. Move IPs from Your server IPs to IP Access Rules with the Allow action, or turn off a published IP list you don’t need.
Deploy fails for one zone after I added a custom expression. The expression isn’t valid Cloudflare rules syntax. Check it in Cloudflare’s expression builder, fix it and deploy again.
Real visitors are being challenged. Check which rule acted in Security Events. Common causes: Rule 4’s country restriction is on for a site with international visitors, or visitors use a VPN covered by Rule 5. Switch Rule 3’s action to Managed Challenge if business proxies are affected.
Zone Status and reports#
Zone Status says “No data yet” or the numbers don’t change. Tick Auto-sync, click Save, then Sync Now. Syncing runs on WP-Cron, which needs site visits; on a quiet site, set up a server cron that calls wp-cron.php at least every hour.
The zone detail view shows a yellow note or a section is missing. The zone’s Cloudflare plan keeps less history or doesn’t include that dataset. The note says how much data the section covers. This is a Cloudflare limit.
A monthly report didn’t arrive. Check the Send log on Clients & Reports for an error. Reports need WP-Cron to run and WordPress to be able to send email. If the log shows nothing, WP-Cron isn’t running: add a server cron. If it says WordPress couldn’t send the email, install an SMTP plugin.
Reports land in spam. Install an SMTP plugin, and set From email in Branding to an address on a domain your mail service is allowed to send for.
“No analytics could be read for this client’s sites, so nothing was sent.” The client’s sites aren’t in the Cloudflare account chosen for the client, or the token lacks Zone → Analytics → Read. Edit the client and check the account and sites.
SSL, health checks and other screens#
The site shows a Cloudflare 525 or 526 error after changing SSL mode. The server doesn’t accept HTTPS (525) or its certificate isn’t valid for Full (strict) (526). Change SSL Mode back on Zone Controls, fix the certificate on the server, then try again.
WordPress loops on redirects. The zone’s SSL mode is probably Flexible. Set it to Full (strict) once the server has a valid certificate. SSL & Insights finds every zone with this problem.
A health check shows Unhealthy but the site works. Your WAF rules or Bot Fight Mode may block the check. Add the user agent Cloudflare-Healthchecks to Custom User Agents to Allow in Rule 1 and deploy again. Also check the Host header and expected codes.
Security Events says a Pro plan is required. Cloudflare only offers firewall event logs through the API on Pro zones and higher. Use the Security events section of the zone detail view on Zone Status, or hide the screen in Settings.
The admin bar reads “Purge: Open Zone Controls page”. Saving Settings with no zone picked caused this in 1.0.27. Update to 1.0.27.1; the label goes back to Purge CF Cache without saving again.
AI and MCP#
My MCP client shows no WP WAF Manager tools. Check Settings → AI & MCP: it must not be Off, the MCP Adapter plugin must be active, and the site must run WordPress 6.9 or later. Use the server address shown there.
The client gets 401 or 403 errors. Check the username and application password, and that the user has the plugin’s minimum role and is on the User Access list if you use one. See AI and MCP.
FAQ#
Does it work on Cloudflare’s Free plan? Yes. Every screen works on Free except Security Events and Health Checks. See Cloudflare Free plan limitations.
Do I install it on every client site? No. Install it on one WordPress site and connect your Cloudflare accounts. Every zone in those accounts can then be managed from there.
Does it slow down my sites? No. Firewall rules and other settings run on Cloudflare’s network, not in WordPress. The plugin only contacts Cloudflare when you use its screens, sync analytics or send reports.
If I deactivate or delete the plugin, are my Cloudflare rules removed? No. Everything you deployed stays in Cloudflare. Deactivating also keeps all plugin data, and deleting keeps it unless you turned off Keep data on uninstall.
Where are my API credentials stored? In the WordPress database, encrypted with libsodium using a key derived from your site’s AUTH_KEY. You can keep them out of the database entirely with wp-config.php constants. See Connecting to Cloudflare.
Can other users on the site use the plugin? Only administrators by default. Change it with Minimum role and Allowed admin users in Settings.
Can AI tools change my Cloudflare settings? Only if you allow it. Settings → AI & MCP offers Read and change, Read only or Off, and AI tools act with the access of the user they sign in as.
What’s the difference between Free and Pro? Nothing in the features. Pro adds automatic updates inside WordPress and priority support.
Was this helpful?
Thanks for your feedback!
✓ Feedback received. Thank you!