Skip to content

Changelog & Release Notes

Official version history and release notes for WP Zbridge.

All notable changes to WP Zbridge are documented on this page.


Release Date: October 2026

  • Reddit Pixel: Page visits, purchases with value, currency and order ID, leads and sign-ups. See Reddit Pixel.
  • X (Twitter) Pixel: Page views, plus purchase and lead conversions for the X event IDs you enter. See X (Twitter) Pixel.
  • Subscription Renewals (Pro): Renewal orders are sent from the server straight away, marked as renewals, and kept out of the orders-missed totals. See Refunds, Cancellations & Renewals.
  • Orders the Browser Never Reported: The free edition’s dashboard shows how many paid orders never reached Zaraz from the visitor’s browser. See Tracking Dashboard.
  • Setup Progress: Setup Health shows how many setup steps are done until setup is complete.
  • Roll Back Last Sync (Pro): Restores the Zaraz configuration exactly as Cloudflare had it.
  • Licensing: Pro features are unlocked only by an active license; development sites use a test license.

Release Date: October 2026

  • Certificate Checks: The server fallback’s DNS lookup keeps certificate checks on.
  • Support Info: Copy support info leaves the HTTP Events API path out of log lines. See Logging.

Release Date: October 2026

  • Update Screens (Pro): Pro updates show the plugin icon and banners on the WordPress update screens.

Release Date: October 2026

  • Roll Back Last Sync (Pro): Puts back the Zaraz configuration saved just before your last sync. See Backups & Rolling Back.
  • Publishing: Sync publishes only on zones that use Zaraz’s Preview & Publish workflow; other zones apply the changes at once.
  • Live Zaraz Activity (Pro): The activity card updates together with Setup Health, without reloading the page.
  • Admin Messages: Every message in the plugin’s admin screens can be translated on translate.wordpress.org.

Release Date: October 2026

  • Always Current: Updates by itself when you open the dashboard and after you save settings, sync or download the container. Recheck runs the checks again with fresh data from Cloudflare. See Tracking Dashboard.
  • Fix Buttons: Problems come with a button that fixes them: Sync to Zaraz (Pro) or Download container for an outdated container, and Add the token for a missing Meta or TikTok access token.
  • Cleared by a Sync: Rejected requests are counted from your last sync when it is within the last 24 hours, so a fixed problem disappears once you sync.
  • One Name: The sync button and its messages are called Sync to Zaraz everywhere. See Sync to Zaraz.

Release Date: October 2026

  • Sees What the Browser Sees: Loads your homepage in your browser and lists the cookies, local and session storage and third-party sites it uses, plus the cookies your server sets. Each item is matched to a known provider or listed as not recognised. See Cookie Banner.
  • Detailed Logging: Logs every event dispatch and check, and switches itself off after 24 hours. See Logging.
  • Zaraz Debugger: Opens your site with the Cloudflare Zaraz debugger turned on.
  • Copy Support Info: Versions, Setup Health, settings and recent log lines, with tokens and keys left out.
  • Site Health: WP Zbridge’s setup details and a setup check appear in Tools > Site Health.
  • Everywhere You Need Them: On the Plugins screen, in the plugin header, on every tab, for every recipe and for each Setup Health item.
  • One Lead per Form in GA4: Form submissions reach GA4 once, as generate_lead.
  • Clear Zaraz History: Configurations WP Zbridge publishes are labelled “WP Zbridge sync” in Zaraz’s version history.

Release Date: October 2026

  • Setup Health: Checks whether Zaraz has your latest container, whether Meta and TikTok have their access tokens, and how consent is collected. See Tracking Dashboard.
  • Zaraz Activity (Pro): Actions per tool, events received and requests your tools rejected in the last 24 hours, from Cloudflare’s Zaraz Monitoring API.
  • 30-Day Totals: Order delivery totals cover the last 30 days. Cloudflare traffic statistics use Cloudflare’s GraphQL Analytics API.
  • Customer Matching (Pro): Optional setting that adds the buyer’s email, phone, name and address to purchases the server sends, for Meta, TikTok and Pinterest. Their Zaraz tools hash the details. Off by default.
  • Preferences Dialog: Opens centred, with Accept All as the main button.
  • Setup Wizard: Asks for the Meta access token and the Google Ads conversion ID and label.
  • Translation-Ready: The cookie banner and admin screens can be translated on translate.wordpress.org.
  • Instagram Shortcode: Also accepts a pasted link or embed code.

Release Date: October 2026

  • WordPress.org Text Domain: The text domain matches the WordPress.org plugin slug (zbridge), so translations from translate.wordpress.org load automatically.

Release Date: October 2026

  • Ad Click Attribution: Google Ads loads on every page view, keeping the ad click ID from the landing page for later conversions and building remarketing audiences.
  • Lead Conversions: New optional lead conversion label that counts form submissions as a Google Ads conversion.
  • Recommended Lead Event: Form submissions are also sent to GA4 as the recommended generate_lead event.
  • Event Properties: Lead, Contact, CompleteRegistration and custom events now include their event properties (form ID, file name, link URL and similar) for use in custom conversion rules.
  • Pinterest Tag: The Pinterest recipe uses the Zaraz Pinterest tool.
  • TikTok, Snapchat & Bing: Click and visitor IDs (ttclid, scid, msclkid) are kept through Zaraz client storage.
  • LinkedIn Insight Tag (Pro): New recipe with page views and optional purchase and lead conversions.
  • Pinterest Conversions API (Pro): Add to cart and purchases are sent from Cloudflare’s servers. Purchases carry the same event ID as the Pinterest Tag, so Pinterest counts them once.
  • Privacy-Friendly Embeds: Show Instagram posts and reels through the Zaraz Instagram tool by pasting a link or with the [zbridge_instagram] shortcode. Visitors load no Instagram script and get no Instagram cookies.

Release Date: October 2026

  • WP Consent API & Cookiebot: Full support for WP Consent API change events and Cookiebot consent decline states across Google Consent Mode and Cloudflare Zaraz.
  • Privacy Hardening: Excluded customer personal contact information from e-commerce payloads.
  • Verified Telemetry: Dashboard reporting displays measured order delivery metrics and browser versus server dispatch split.

Release Date: October 2026

  • Landing Page Attribution: Preserved landing page and traffic source attribution for new visitors by queuing initial pageview until consent is resolved.
  • Server Dispatch Context: Forwarded visitor Zaraz consent status in server fallback purchase dispatches.
  • Data Normalization: Standardized product ID formatting across all e-commerce events.

Release Date: September 2026

  • GA4 Event Names: Engagement events standardized on Google Analytics 4 conventions (scroll, file_download, click, form_submit, login, sign_up).
  • Site Search: Forwarded as Zaraz Products Searched e-commerce event across supported analytics and ad platforms.
  • Standard Conversion Goals: Lead form submissions, email/phone clicks, and account registrations dispatched as standard conversion events (Lead, Contact, CompleteRegistration).
  • API Token Validation: Added requirement validation for Meta Conversions API and TikTok Events API access tokens.

Release Date: September 2026

  • Cache-Safe Geo-Targeting: Client-side country lookup for EU cookie banner targeting, ensuring full compatibility with page caching plugins and edge caches.
  • Script Optimizer Compatibility: Ensured cookie banner and consent bridge scripts execute reliably when external minification or deferral tools are active.
  • Automated Actions: Enabled automated recipe actions across exported Zaraz containers.

Release Date: August 2026

  • Comprehensive Event Delivery: Full event tracking for product views, cart additions, cart removals, checkout progress, and purchases.
  • Dynamic Cart Tracking: AJAX add-to-cart tracking for standard buttons, product forms, and block-based carts.
  • Zaraz E-commerce Format: Standardized payloads using order_id, products, total, Product Removed, and Order Refunded.
  • Order Deduplication: Server-side purchase fallback with automatic 10-minute deduplication for dropped browser orders.
  • HTTP Events API: Dedicated per-site Zaraz HTTP Events API path for secure server dispatch with unique debug keys.
  • Google Consent Mode v2: Full consent purpose mapping across all active analytics and advertising tools.

Release Date: August 2026

  • Unified Container Generation: Synchronized schema between manual JSON export and 1-click Cloudflare API sync.
  • Cloudflare Dashboard Compatibility: Complete UUID and container schema mapping for direct dashboard imports.
  • Filtered Exports: Export files include only configured tools and credentials.
  • Server-Side Ecommerce Flag: Added Zaraz e-commerce flags to server-side orders and refund dispatches.

Release Date: July 2026

  • Automated Event Forwarding: Enabled Zaraz automated actions for Google Analytics 4 for zero-configuration event forwarding.
  • Streamlined Defaults: Simplified configuration defaults for Google Analytics 4 setups.

Release Date: June 2026

  • WordPress Standards: Full coding standards compliance and text domain normalization.
  • Security & Sanitization: Strict input sanitization for Cloudflare geolocation headers (HTTP_CF_IPCOUNTRY) and escaped privacy settings outputs.
  • Asset Registration: Migrated administration assets to registered WordPress action hooks.
  • Service Disclosures: Standardized external service disclosures covering Cloudflare Zaraz, Google Analytics, and Meta Pixel.

Release Date: May 2026

  • Edge Geo-Targeting: Evaluates visitor country codes across 32 European jurisdictions (EU/EEA/UK/CH) to grant consent and eliminate banner fatigue outside Europe.
  • Early Google Consent Mode v2: Synchronous initialization in <head> with returning visitor cookie detection.
  • Granular Preferences Modal: Accessible dialog featuring 4 category controls (Strictly Necessary, Analytics, Marketing, Functional).
  • Theming Controls: Supports Auto (OS preference), Light, and Dark modes with custom color overrides.
  • Privacy Policy Integration: Dynamic permalink resolution for WordPress privacy pages.

Release Date: April 2026

  • Distinct Plugin Identity: Formatted distinct plugin titles and descriptions in WordPress admin for Pro and Lite editions.
  • Mutual Exclusion Guard: Automated mutual exclusion preventing dual-activation class collisions.
  • Plugin Directory Badges: Introduced visual edition badges in the WordPress plugins table.
  • Edge Lite Distribution: Public release distribution pipeline for Lite releases via Cloudflare R2 storage.

Release Date: March 2026

  • Navigation Visual Indicators: Added tab icons across administration settings views for faster section identification.
  • Cloudflare API Hardening: Enhanced REST API synchronization routines, connection validation, and error handling.
  • Connection Fallback: Added automated connection mode validation and manual export fallback handling.
  • Edge Observability: Updated Wrangler configuration with structured logging and execution telemetry.

Release Date: February 2026

  • Expanded 7-Tab Admin Layout: Segmented administration settings into 7 focused views: Dashboard, Setup, Cloudflare, Recipes, Consent, Diagnostics, and Settings.
  • Dashboard Telemetry Navigation: Direct navigation shortcuts from telemetry cards to settings.
  • Modular Packaging: Clean separation of tracking modules and distribution archives.

Release Date: January 2026

  • User Engagement Tracking Suite: Automated active time-on-page milestones, email/phone link click tracking, and scroll depth monitoring.
  • Lead Form Submission Tracking: Dedicated integrations for Contact Form 7, WPForms, Gravity Forms, Fluent Forms, Elementor Forms, and generic HTML forms.
  • User Lifecycle Tracking: Captures user login, registration, and comment submission events.
  • Telemetry Dashboard: Real-time telemetry card displaying server-side dispatches and delivery status.

Release Date: December 2025

  • Setup Wizard Auto-Hide & Relaunch: Wizard automatically hides from the admin menu upon completion, with instant relaunch controls available from Dashboard and Diagnostics.
  • Site Slot Release: Capability to release site slots directly from WordPress admin for domain transfers.
  • Visual Documentation: Visual guide walkthroughs across documentation covering onboarding, Cloudflare configuration, and Zaraz recipes.

Release Date: November 2025

  • Edge Handshake Verifier: Real-time Anycast latency testing and Cloudflare PoP airport code detection in WordPress admin.
  • Manual Order Attribution: Trigger conversion recovery for telephone, B2B, or offline orders directly from WooCommerce order actions.
  • Payload Sanitization: Optimized edge payload dispatch routines and parameter normalization.

Release Date: November 2025

  • Automated Cookie & Tracker Scanner: Audits front-end scripts and categorizes discovered cookies into Essential, Analytics, Marketing, and Functional groups.
  • 4-Step Setup Wizard: Interactive guided onboarding for connecting Cloudflare API tokens, configuring zones, and deploying recipes.
  • Reopen Consent Badge: Accessible floating badge allowing visitors to modify cookie preferences at any time.
  • Snapchat Pixel & Conversions API Recipe: Pre-configured Zaraz recipe for Snapchat Pixel and Conversions API.
  • Variation Parent ID Resolution: Resolves variable product variations to parent catalog IDs to prevent catalog mismatch errors.
  • Product & Funnel Tracking: Tracking for variant selections, checkout payment info, and site search.
  • Staff Exclusion: Automatically excludes logged-in store administrators and staff from analytics events.

Version 1.2.0 Initial Release

Section titled “Version 1.2.0 ”

Release Date: October 2025

  • Cloudflare Zaraz Edge Bridge: Offloads tracking scripts to Cloudflare’s edge network, reducing browser JavaScript payload.
  • Hybrid Conversion Recovery: Server-side fallback engine that dispatches purchases from WooCommerce when browser delivery is interrupted.
  • Deterministic Deduplication: Unifies client-side browser events and server-side fallbacks with shared event IDs to prevent duplicate conversions in GA4, Meta, and Google Ads.
  • Recipe Catalog: Pre-configured recipes for Google Analytics 4, Meta Conversions API, TikTok Events API, Google Ads, Pinterest, and Microsoft Advertising (Bing).
  • Google Consent Mode v2: Full support for Google Consent Mode v2 parameters mapped directly to Cloudflare Zaraz consent purposes.
  • Lightweight Cookie Banner: Standalone, accessible cookie consent banner with zero external library dependencies.