Docs
← Back to site

Settings PageUpdated

5 min readUpdated November 18, 2026

The Settings page holds the plugin-wide preferences: the admin bar purge button, analytics syncing, who can use the plugin, what AI tools may do, what happens to your data on uninstall, and which screens appear in the menu.

Go to WAF Manager → Settings. Changes take effect only when you click Save Settings at the bottom; the page then reloads so menu and admin bar changes show. The User Access list has its own Save Access Settings button.

WP WAF Manager Settings screen

Admin Bar Quick Purge#

Setting Default What it does
Enable admin bar button On Shows a cache purge button in the WordPress admin bar
Zone to purge Open Zone Controls page The zone the button purges. Leave it on Open Zone Controls page to pick a zone each time
Click action Purge everything instantly (AJAX) Purge everything instantly purges the chosen zone’s whole cache with no prompt. Open Zone Controls page opens Zone Controls instead

With no zone chosen, the button reads Purge CF Cache and opens Zone Controls. With a zone chosen, it reads Purge: and the zone’s name, and shows Purging…, then Cache Purged, when clicked. Instant purge works from admin pages. The button only appears for users who can use the plugin.

Zone Analytics#

Setting Default What it does
Auto-sync Off Fetches Zone Status data from Cloudflare on a schedule using WP-Cron
Sync interval Every hour Every 5, 15 or 30 minutes, every hour, or every 6 or 24 hours. Applies when auto-sync is on
Default time range Last 7 days How much history the Zone Status cards cover: 24 hours, 7, 14 or 30 days

These are the same options as the bar on Zone Status. Saving this page overwrites the values set there.

Access Control#

Minimum role sets the lowest WordPress role that can use the plugin. The default, and the recommended choice, is Administrator. Editor, Author, Contributor and Subscriber are marked Not recommended for security plugins, because the plugin controls firewall rules, DNS, email routing and your Cloudflare credentials.

Keep data on uninstall is on by default:

  • On (Keep data): deleting the plugin leaves all its data in the database, so reinstalling picks up where you left off.
  • Off (Delete data on uninstall): deleting the plugin permanently removes its data (listed below).

Even when it’s off, nothing is removed while another copy of the plugin is still installed, because all copies share the same data. Deactivating never removes data.

Test connection checks the active account’s credentials. Click Test Connection: a working connection shows the account name and how many active zones it can see. Run it after rotating a token or changing its permissions.

AI & MCP#

AI and MCP settings with the abilities choice, the MCP server address and the 16 abilities

Abilities for AI tools decides what AI tools and MCP clients may do through the WordPress Abilities API:

  • Read and change (default): all 16 abilities, including deploying rules, purging cache and changing zone settings.
  • Read only: the 9 abilities that only read.
  • Off: no abilities and no MCP server.

Status shows whether the Abilities API is available (WordPress 6.9 or later), whether the MCP Adapter plugin is active, the plugin’s MCP server address and the abilities on offer. AI tools act as the user they sign in as, with the same access rules as the screens. See AI and MCP.

User Access#

Allowed admin users limits the plugin to specific administrators.

  • With no users selected, everyone allowed by Minimum role can use the plugin.
  • Once you save a list, only the ticked users can use it, whatever their role.
  • Super Admins on multisite always have access. Your own account is always included and can’t be unticked.

Tick the administrators who should have access and click Save Access Settings. Users without access don’t see the menu, the admin bar button, the dashboard widget or the plugin on the Plugins screen, and can’t use the AI and MCP abilities.

Setting Default What it does
Dashboard widget Visible Shows a WP WAF Manager card on the WordPress Dashboard with the account, monitored zones and sync status
Hide Security Events Visible Removes Security Events from the menu. Useful when all your zones are on the Free plan
Hide Email Routing Visible Removes Email Routing from the menu if you don’t use Cloudflare email forwarding
Hide other screens None hidden Tick any of Clients & Reports, Bot Control, SSL & Insights, Alerts & Health, Turnstile and Page Rules to remove them from the menu
WP WAF Manager widget on the WordPress dashboard

The dashboard widget links to Zone Controls, Zone Status and WAF Rules.

Hiding a screen only removes it from the menu; nothing else changes. Monthly client reports keep sending even when Clients & Reports is hidden. The About page still lists hidden screens, marked Hidden in Settings.

WAF Rules, Zones, DNS Manager, Zone Status, IP Access Rules, Zone Controls, Settings and About are always shown.

What uninstall removes#

When Keep data on uninstall is off and no other copy is installed, deleting the plugin removes:

  • Connected Cloudflare accounts and credentials.
  • WAF rule settings, Rule Profiles and Domain Profiles.
  • Zone Status settings and cached analytics.
  • Zone flares.
  • The allowed users list.
  • SSL & Insights scan results.
  • Clients, report branding and the send log.
  • All plugin settings.

It also stops the analytics sync and monthly report schedules. Nothing in Cloudflare is changed: rules, DNS records and other settings you deployed stay in place. Your Pro license details are kept.

Suggested setup#

  • Hide the screens you don’t use.
  • Admin bar button on, zone set to your main site, click action Open Zone Controls page if you share the admin with others.
  • Auto-sync on, every hour, last 7 days.
  • Minimum role Administrator; add an allowed users list if several people share the admin.
  • AI & MCP on Read only until you’ve tried it, then Read and change if you want AI tools to act for you.
  • Keep data on uninstall on.
Share:

Was this helpful?

This website uses cookies to enhance your browsing experience and ensure the site functions properly. By continuing to use this site, you acknowledge and accept our use of cookies.

Accept All Accept Required Only