Changelog & Release Notes
Official version history and release notes for WP Zbridge.
All notable changes to WP Zbridge are documented on this page.
Version 1.5.0 Latest
Section titled “Version 1.5.0 ”Release Date: October 2026
🎯 New Recipes (Pro)
Section titled “🎯 New Recipes (Pro)”- 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.
🛒 WooCommerce
Section titled “🛒 WooCommerce”- 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.
🍪 Consent
Section titled “🍪 Consent”- Borlabs Cookie 3: Consent choices are passed to Google Consent Mode v2 and Zaraz. See CMP Plugins Compatibility.
🛠️ Setup & Sync
Section titled “🛠️ Setup & Sync”- 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.
Version 1.4.4
Section titled “Version 1.4.4”Release Date: October 2026
🔒 Security
Section titled “🔒 Security”- 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.
Version 1.4.3
Section titled “Version 1.4.3”Release Date: October 2026
🔄 Updates
Section titled “🔄 Updates”- Update Screens (Pro): Pro updates show the plugin icon and banners on the WordPress update screens.
Version 1.4.2
Section titled “Version 1.4.2”Release Date: October 2026
🔁 Sync to Zaraz
Section titled “🔁 Sync to Zaraz”- 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.
📊 Dashboard
Section titled “📊 Dashboard”- Live Zaraz Activity (Pro): The activity card updates together with Setup Health, without reloading the page.
🌍 Translations
Section titled “🌍 Translations”- Admin Messages: Every message in the plugin’s admin screens can be translated on translate.wordpress.org.
Version 1.4.1
Section titled “Version 1.4.1”Release Date: October 2026
📊 Setup Health
Section titled “📊 Setup Health”- 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.
🔁 Sync to Zaraz
Section titled “🔁 Sync to Zaraz”- One Name: The sync button and its messages are called Sync to Zaraz everywhere. See Sync to Zaraz.
Version 1.4.0
Section titled “Version 1.4.0”Release Date: October 2026
🍪 Cookie Scanner
Section titled “🍪 Cookie Scanner”- 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.
🛠️ Debugging
Section titled “🛠️ Debugging”- 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.
📚 Documentation Links
Section titled “📚 Documentation Links”- Everywhere You Need Them: On the Plugins screen, in the plugin header, on every tab, for every recipe and for each Setup Health item.
📈 Tracking
Section titled “📈 Tracking”- 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.
Version 1.3.9
Section titled “Version 1.3.9”Release Date: October 2026
📊 Dashboard
Section titled “📊 Dashboard”- 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.
🛒 WooCommerce Tracking
Section titled “🛒 WooCommerce Tracking”- 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.
🍪 Consent
Section titled “🍪 Consent”- Preferences Dialog: Opens centred, with Accept All as the main button.
🪄 Setup & Translations
Section titled “🪄 Setup & Translations”- 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.
Version 1.3.8
Section titled “Version 1.3.8”Release Date: October 2026
🌍 Translations
Section titled “🌍 Translations”- WordPress.org Text Domain: The text domain matches the WordPress.org plugin slug (
zbridge), so translations from translate.wordpress.org load automatically.
Version 1.3.7
Section titled “Version 1.3.7”Release Date: October 2026
🎯 Google Ads
Section titled “🎯 Google Ads”- 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.
📊 Google Analytics 4
Section titled “📊 Google Analytics 4”- Recommended Lead Event: Form submissions are also sent to GA4 as the recommended
generate_leadevent.
📘 Meta
Section titled “📘 Meta”- 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.
🧩 Recipes
Section titled “🧩 Recipes”- 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.
📷 Instagram Embeds
Section titled “📷 Instagram Embeds”- 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.
Version 1.3.6
Section titled “Version 1.3.6”Release Date: October 2026
🔒 Consent & Privacy
Section titled “🔒 Consent & Privacy”- 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.
📊 Dashboard & Telemetry
Section titled “📊 Dashboard & Telemetry”- Verified Telemetry: Dashboard reporting displays measured order delivery metrics and browser versus server dispatch split.
Version 1.3.5
Section titled “Version 1.3.5”Release Date: October 2026
🔒 Consent & Attribution
Section titled “🔒 Consent & Attribution”- 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.
🛒 E-commerce Formatting
Section titled “🛒 E-commerce Formatting”- Data Normalization: Standardized product ID formatting across all e-commerce events.
Version 1.3.4
Section titled “Version 1.3.4”Release Date: September 2026
📊 Events & Conversions
Section titled “📊 Events & Conversions”- 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 Searchede-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).
🔧 Integrations
Section titled “🔧 Integrations”- API Token Validation: Added requirement validation for Meta Conversions API and TikTok Events API access tokens.
Version 1.3.3
Section titled “Version 1.3.3”Release Date: September 2026
🔒 Cookie Banner & Caching
Section titled “🔒 Cookie Banner & Caching”- 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.
📦 Zaraz Container
Section titled “📦 Zaraz Container”- Automated Actions: Enabled automated recipe actions across exported Zaraz containers.
Version 1.3.2
Section titled “Version 1.3.2”Release Date: August 2026
🛒 WooCommerce Tracking Suite
Section titled “🛒 WooCommerce Tracking Suite”- 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, andOrder Refunded. - Order Deduplication: Server-side purchase fallback with automatic 10-minute deduplication for dropped browser orders.
📦 Edge Infrastructure
Section titled “📦 Edge Infrastructure”- 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.
Version 1.3.1
Section titled “Version 1.3.1”Release Date: August 2026
📦 Zaraz Container Export
Section titled “📦 Zaraz Container Export”- 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.
Version 1.3.0
Section titled “Version 1.3.0”Release Date: July 2026
📊 GA4 Recipe
Section titled “📊 GA4 Recipe”- 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.
Version 1.2.9
Section titled “Version 1.2.9”Release Date: June 2026
🛡️ Standards Compliance & Security
Section titled “🛡️ Standards Compliance & Security”- 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.
Version 1.2.8
Section titled “Version 1.2.8”Release Date: May 2026
🔒 Consent Suite & Geo-Targeting
Section titled “🔒 Consent Suite & Geo-Targeting”- 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.
Version 1.2.7
Section titled “Version 1.2.7”Release Date: April 2026
🛠️ Core Architecture & Packaging
Section titled “🛠️ Core Architecture & Packaging”- 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.
Version 1.2.6
Section titled “Version 1.2.6”Release Date: March 2026
🛠️ Admin Navigation & Cloudflare API
Section titled “🛠️ Admin Navigation & Cloudflare API”- 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.
Version 1.2.5
Section titled “Version 1.2.5”Release Date: February 2026
🚀 Navigation & Packaging
Section titled “🚀 Navigation & Packaging”- 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.
Version 1.2.4
Section titled “Version 1.2.4”Release Date: January 2026
🚀 Engagement & Form Tracking
Section titled “🚀 Engagement & Form Tracking”- 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.
Version 1.2.3
Section titled “Version 1.2.3”Release Date: December 2025
🚀 Administration & Licensing
Section titled “🚀 Administration & Licensing”- 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.
Version 1.2.2
Section titled “Version 1.2.2”Release Date: November 2025
🚀 Diagnostics & Attribution
Section titled “🚀 Diagnostics & Attribution”- 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.
Version 1.2.1 Previous
Section titled “Version 1.2.1 ”Release Date: November 2025
🚀 Onboarding & E-commerce Enhancements
Section titled “🚀 Onboarding & E-commerce Enhancements”- 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
🚀 Core Architecture Launch
Section titled “🚀 Core Architecture Launch”- 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.