Skip to content

Install WebDecoy on WP Engine

WP Engine already serves your site through Cloudflare, but through WP Engine’s Cloudflare account, where you cannot add anything. Cloudflare’s Orange-to-Orange (O2O) setup puts your own Cloudflare zone in front of it. Your zone runs first, so the WebDecoy edge sensor can run there and see every request to the site: AI crawlers, search crawlers, scrapers and curl, including requests for pages WP Engine answers from cache.

That last part matters on WP Engine. WP Engine serves anonymous page views from its page cache, before WordPress runs, so the WordPress plugin never sees those requests and its crawler counts are minimums. The edge sensor sees them. Keep the plugin as well if you want its form, login and WooCommerce protection: the two see different things.

  • A Cloudflare account (Free works) with your domain added as a zone, so Cloudflare runs its DNS.
  • The domain connected in WP Engine.
  • A WebDecoy account with this site added under the address visitors use, for example https://www.example.com. Create a free account.

1. Point your hostname at WP Engine through Cloudflare

Section titled “1. Point your hostname at WP Engine through Cloudflare”

In your Cloudflare zone, open DNS → Records and create a record for each hostname you want covered (usually the root and www):

  • Type: CNAME
  • Name: the hostname, for example www
  • Target: see the table
  • Proxy status: Proxied (orange cloud)
Your WP Engine network CNAME target
Global Edge Security wp.wpewaf.com
Advanced Network wp.wpenginepowered.com

Use the target for the network your site is on. WP Engine’s User Portal shows it with the domain. Cloudflare flattens a CNAME on the root domain automatically.

The orange cloud is required. On a DNS-only record your zone is skipped, and the sensor never runs.

Add the domain in the WP Engine User Portal if it is not there yet, and let WP Engine finish its checks and issue the certificate. Once WP Engine accepts the domain, requests go visitor → your Cloudflare zone → WP Engine’s Cloudflare zone → WP Engine.

  1. In WebDecoy, select the site.
  2. Open Integrations → Cloudflare and choose Connect with Cloudflare, then approve the scopes on Cloudflare’s consent screen.
  3. Open Edge Sensor, choose the zone, and set the route to cover each hostname, for example www.example.com/* and example.com/*.
  4. Select Deploy edge sensor.

No code is involved. The edge sensor guide covers the details, including Worker usage and the static-file paths it skips.

Terminal window
curl -A "WebDecoy-Test/1.0" https://www.example.com/

Swap in your own address. Within a minute a detection labelled Test appears, and Sensors shows the Edge Worker row as Reporting. Then let real traffic arrive: most public sites see search and AI crawlers within hours.

The edge sensor reports. The WordPress plugin adds what only WordPress can see: comment, login and registration protection, WooCommerce checkout signals, and local counts in your WordPress dashboard. Install it from Plugins → Add New by searching for WebDecoy.

  • The sensor does not block. It reports, and it lets the request through on any error of its own. Cloudflare notes that a Worker on the O2O hostname can interfere with traffic; the sensor only changes a response when you turn on enforcement for a path.
  • Zone hold (Cloudflare Enterprise). If WP Engine reports “The hostname is associated with a held zone”, release the hold temporarily (for a subdomain, turn off Also prevent Subdomains), then refresh the domain in WP Engine.
  • Certificates. If you have CAA records, they must allow a certificate authority Cloudflare and the host use (Let’s Encrypt is the usual one), or HTTPS can fail.
  • One edge sensor per organization, today. Other sites in the same WebDecoy organization can report through the WordPress plugin, an SDK or the browser script.
  • Support. For problems in your own Cloudflare zone, Cloudflare Support helps and consults WP Engine where needed.

Verify the install, then see what crawlers did in your site’s first report.