Docs
← Back to site

Installation and Updates

4 min readUpdated November 18, 2026

Installing takes about two minutes: upload the zip in WordPress and activate it. The free and Pro versions are the same plugin. Pro adds a license that turns on automatic updates.

Step 1: Download the plugin#

  • Pro: log in to your account at wpwafmanager.com and download the latest zip from your purchases.
  • Free: download the latest release zip from the GitHub releases page.

Keep the file zipped. WordPress installs the zip as it is.

Step 2: Install and activate#

  1. In WordPress, go to Plugins → Add New and click Upload Plugin.
  2. Choose the zip and click Install Now.
  3. Click Activate Plugin.

A WAF Manager menu with a shield icon appears in the admin sidebar, and a WP WAF Manager widget appears on the WordPress dashboard. Next, connect your Cloudflare account: see Connecting to Cloudflare.

Installing by FTP or SFTP: unzip the file on your computer and upload the wpwafmanager folder to /wp-content/plugins/, then activate the plugin on the Plugins screen. Keep the folder name wpwafmanager: licensing and updates expect it.

Step 3: Activate your license (Pro only)#

  1. Go to WAF Manager → License (the last item in the menu).
  2. Paste the license key from your wpwafmanager.com account.
  3. Click Activate License. You’ll see “This site was successfully activated.”

Only administrators can see the License page. Free users skip this step: every feature works without a license.

To move a license to another site, click Deactivate License on the old site first, then activate it on the new one.

Updating: Pro#

With an active license, new versions appear like any other plugin update, under Plugins and Dashboard → Updates. Click Update now. WordPress checks for a new version every few hours. Open Dashboard → Updates to check straight away.

Updating: Free#

When a new version is out, the WordPress Dashboard shows “WP WAF Manager X is available” with a Download free button. Dismiss it and it comes back the next day.

  1. Download the new zip.
  2. Go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now.
  3. WordPress says the plugin is already installed and compares the two versions. Click Replace current with uploaded.

Don’t delete the old version first. Replacing keeps the plugin active and your settings untouched, and never runs the uninstall cleanup.

After an update: redeploy or not?#

Your settings, accounts, profiles and clients are kept by every update. When a release changes the WAF rules, the saved rule settings are moved to the new layout for you, and the release’s upgrade notice says “Redeploy to your zones”. Open WAF Rules and deploy again to send the new rules to Cloudflare; until then, your zones keep running the old rules.

Releases that don’t change the rules, such as 1.0.27 (AI and MCP) and 1.0.27.1 (display fixes), need no redeploy. The changelog lists what each release changes.

Safe updates (1.0.24.1 and later)#

From 1.0.24.1, the plugin protects your setup during updates:

  • Updates stay in your folder. Updates and zip uploads always go into the folder the plugin already runs from, even if that folder has another name (such as wpwafmanager-main from a GitHub download) or the zip has an extra wrapper folder.
  • A second copy is flagged. If another copy of the plugin is installed, the Plugins screen and the plugin’s screens show a notice with its folder and version. You can delete that copy safely.
  • Two active copies can’t break the site. If two copies are active, only one loads and a notice names the copy to deactivate and delete.
  • Deleting a spare copy keeps your settings. All copies share the same settings, so they are never deleted while another copy is still installed.

Updating from 1.0.23 or earlier#

An update runs the code of the version you are updating from, and the protections above start with 1.0.24.1. Check the plugin’s folder name in /wp-content/plugins/ before you update:

  • Folder named wpwafmanager: update as normal.
  • Any other name: do this update by hand, just this once:
    1. In WAF Manager → Settings, make sure Keep data on uninstall is on.
    2. Deactivate the old version.
    3. Upload the new zip in Plugins → Add New → Upload Plugin and activate it.
    4. Delete the old copy from the Plugins screen. Your settings stay in place.

Deactivating and deleting#

  • Deactivating stops the plugin and its scheduled tasks (analytics sync and monthly reports). Nothing is deleted, and the rules you deployed stay in Cloudflare.
  • Deleting removes the plugin files. Your settings, accounts, profiles and clients stay in the database unless you turned off Keep data on uninstall in Settings. See Settings Page for what is removed when it is off.

Moving from Cloudflare WAF Manager#

If you used the older plugin called cloudflare-waf-manager, deactivate and delete it before installing WP WAF Manager. The two can’t run at the same time. Your old accounts and rule settings are moved over automatically on first load.

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