Skip to content

Quickstart Guide

Step-by-step guide to installing WP Zbridge and connecting Cloudflare Zaraz in minutes.

Setting up server-side tracking shouldn’t require a computer science degree. With WP Zbridge, you can connect your store to Cloudflare Zaraz in just a few clicks.


You can get started immediately with the free open-source Lite package:

Install from WordPress

In your WordPress dashboard, go to Plugins > Add New Plugin, search for Zbridge, and click Install Now followed by Activate. Updates then arrive through WordPress like any other plugin.


When you activate WP Zbridge for the first time, the 4-Step Setup Wizard launches automatically:

  1. Connect Cloudflare Select Sync to Zaraz (Cloudflare API) (Pro) or Manual Container JSON Export (Lite, no token needed). For the API, enter your API Token and Zone ID and click verify.

    Setup Wizard Step 1: Cloudflare Connection

  2. Select Your Marketing Tools & Recipes Enter your tracking credentials (Google Analytics 4 Measurement ID, Meta Pixel ID, TikTok Pixel, Snapchat Pixel, etc.). WP Zbridge prepares the matching Cloudflare Zaraz tools, actions and triggers.

    Setup Wizard Step 2: Marketing Tools Configuration

  3. Configure Consent & Cookie Banner Enable Google Consent Mode v2 and the built-in cookie banner, and preview the banner.

    Setup Wizard Step 3: Consent Suite & Cookie Banner

  4. Verify & Complete Setup Send a test event to Cloudflare to confirm the connection. Click Complete Setup & Open Dashboard to finish.

    Setup Wizard Step 4: Verification & Completion


If you purchased WP Zbridge Pro, activate your license key to unlock Sync to Zaraz, the server fallback for purchases, the Pro recipes and plugin updates:

WP Zbridge Pro License Activation & Deactivation

  1. Navigate to WP Zbridge > License.
  2. Paste the License Key from your purchase confirmation email and click Activate.
  3. Once active, your Pro status and expiration date appear immediately.

Transferring Your License to Another Domain

Section titled “Transferring Your License to Another Domain”

Need to move your license to a new domain, redesign, or staging environment?

  • Open the License tab on your old site.
  • Click the red Deactivate License button.
  • WP Zbridge contacts the licensing server to free that site’s slot.
  • You can now activate that same license key on your new site without any support tickets or delays.

If you prefer to configure settings manually:

    • In your WordPress admin, go to Plugins > Add New > Upload Plugin.
    • Upload zbridge-pro.zip and click Activate. (For the free Lite edition, install Zbridge from Plugins > Add New Plugin instead.)
    • Go to WP Zbridge > Cloudflare & Edge.
    • Paste your Cloudflare API Token (needs Zone: Read and Zaraz: Edit permissions) and your Cloudflare Zone ID.
    • Click Test Connection to make sure the green checkmark appears.

    Cloudflare API connection and Sync to Zaraz

    • Go to the Zaraz Recipes tab.
    • Turn on your marketing channels (e.g. Meta Pixel, GA4, Snapchat, Google Ads).
    • Paste your Pixel or Measurement ID into the boxes provided.
    • Click Sync to Zaraz.
    • WP Zbridge automatically sets up all tools, triggers, and events on Cloudflare.
    • Your tools now load through Cloudflare Zaraz. With Lite, click Download Container JSON instead and import it in Cloudflare.

1. Test Edge Handshake & Purchases

Go to WP Zbridge > Diagnostics and click Test Live Edge Handshake or Dispatch Simulated Test Purchase. The result shows whether Cloudflare Zaraz received the event, with the CF-Ray ID.

2. Check Page Speed

Test your store on Google PageSpeed Insights before and after removing your old tracking tags, and compare the third-party JavaScript it reports.