Pixel Platform Compatibility

Summary: Not all website platforms support the Delivr pixel equally. Platforms like WordPress and Webflow give the pixel full cookie access for identity resolution. Others -- like Wix -- sandbox third-party scripts in ways that block resolution entirely. Shopify works only when the pixel is installed in the theme code, and never on checkout pages. This page explains which platforms work, which don't, and how to check before deploying.

---

Quick Reference

Before quoting pixel resolution to a prospect, ask: "What platform is your website built on?"

---

Why Platform Matters

The Delivr pixel identifies visitors by reading a cookie from their browser and matching it against our identity graph. For this to work, the pixel needs unrestricted access to document.cookie in the visitor's browser.

Some website platforms run third-party scripts in a sandboxed environment that blocks cookie access. When that happens, the pixel loads and fires events, but it can't read or write the cookies needed for identity resolution. The result is near-zero resolution -- not because the identity graph is missing data, but because the pixel can't access the browser data it needs.

flowchart TD
    A[Pixel loads on visitor's browser] --> B{Can pixel access cookies?}
    B -->|Yes| C[Cookie sent to identity graph]
    B -->|No - Sandboxed| D[Event recorded but no resolution]
    C --> E{Match found?}
    E -->|Yes| F[Resolved event with contact data]
    E -->|No| G[Raw event stored]

    style D fill:#ef4444,color:#fff
    style F fill:#22c55e,color:#fff
    style G fill:#6b7280,color:#fff

---

Fully Compatible Platforms

These platforms allow unrestricted pixel installation. Standard resolution rates apply.

---

Conditionally Compatible Platforms

These platforms work but have limitations that may reduce effective resolution rates.

Shopify

• How to install: Online Store > Themes > Edit code > layout/theme.liquid. Paste the pixel script just before </head>. Code in the theme runs on the storefront page itself, with normal first-party cookie access, and resolves at rates comparable to other fully compatible platforms.
• Do not install as a Customer Events custom pixel (Settings > Customer events > Add custom pixel). Shopify runs custom pixels in a sandboxed iframe without access to the storefront's cookies. The pixel fires events there, but resolution drops to roughly 3%, about 90% below a theme install.
• Limitation, checkout: Shopify no longer runs theme code or additional scripts on checkout, Thank you, or Order status pages. The pixel sees storefront pages (home, collections, products, cart) but not checkout steps or completed orders. A Shopify app that captures checkout and order events is in development.
• Limitation, consent: Shopify's cookie banner does not block scripts added to theme code. If the store needs to honor its banner, load the pixel only after the visitor's choice allows it, using Shopify's Customer Privacy API (window.Shopify.customerPrivacy).
• Impact: Storefront resolution is normal. Checkout and purchase activity is not captured.

Squarespace

• How to install: Settings > Advanced > Code Injection > Header
• Limitation: The built-in consent banner can gate custom scripts. If the pixel script is allowed to load, a custom integration must publish the banner's decision to the SDK; the SDK does not read the banner or GPC signal itself. Express-consent regions wait for a grant, while a US implied-consent or opt-out mode can start collection immediately and pass false after an opt-out.
• Impact: Effective resolution depends on the site's CMP configuration and regional traffic mix.

BigCommerce

• How to install: Via Script Manager or custom code in storefront theme
• Limitation: Cookie consent features can gate third-party scripts. If the script loads, your integration must publish the consent decision to the SDK. Express-consent regions wait for a grant; a correctly integrated US opt-out mode can collect until the visitor opts out and then pass false.
• Impact: Effective resolution depends on the configured regional consent mode.

GoDaddy Website Builder

• How to install: Marketing > Tracking section, or custom HTML block
• Limitation: The cookie consent banner may gate third-party tracking according to its regional mode. Custom HTML may also be placed inside iframes, which can prevent some event types from firing.
• Impact: Lower resolution than fully compatible platforms. Test with a small deployment before committing.

WordPress.com (Hosted)

• Limitation: Custom JavaScript requires a Business plan ($33/month) or higher. Free, Personal, and Premium plans do not allow custom code injection.
• Recommendation: Upgrade to Business plan, or switch to self-hosted WordPress (.org) for full pixel functionality.

---

Not Compatible

These platforms have technical restrictions that prevent identity resolution. The pixel may load and fire events, but it cannot access the cookie data needed to identify visitors.

Wix

Wix sandboxes all custom code elements and has removed the ability for third-party scripts to access cookies, localStorage, and sessionStorage. There is no workaround within the Wix platform.

Google Sites

Google Sites does not support custom JavaScript injection. There is no way to install the pixel.

AI Website Builder Preview URLs

This applies to sites accessed via the builder's default preview URLs, not custom domains.

These platforms proxy all traffic through shared cloud infrastructure, masking real visitor IP addresses. Combined with sandbox restrictions, the pixel cannot perform identity resolution.

Important: If a site built with one of these tools is deployed to a custom domain on standard hosting (Netlify, Vercel, AWS, etc.), the pixel works normally. The restriction is on the builder's preview URLs, not the generated code itself.

---

How to Verify a Platform

Step 1: Ask

"What platform or hosting provider is your website built on?"

Step 2: Check the URL

Step 3: Check Page Source

If you have access to the site, right-click > View Page Source and look for platform indicators:

---

Common Questions

"Can you install your pixel on my Shopify store?"

Yes, in the theme code. Add the pixel script to layout/theme.liquid (Online Store > Themes > Edit code), just before </head>. It then resolves visitors on storefront pages normally. Don't add it under Settings > Customer events as a custom pixel: Shopify sandboxes custom pixels, and resolution there drops to roughly 3%. Checkout, Thank you, and Order status pages don't run theme code, so purchases aren't captured. A Shopify app for checkout and order events is in development.

"Why does it work on some platforms but not others?"

The pixel identifies visitors by matching browser data to our identity graph. Some platforms -- like Wix, or Shopify's Customer Events custom pixels -- run third-party scripts in a restricted environment that blocks access to the browser data we need. Think of it like trying to read a book through frosted glass: the book is there, but you can't see the words. Platforms like WordPress and Webflow give us clear, unrestricted access.

"My developer built our site on Lovable / Bolt. Will the pixel work?"

It depends on where the site is hosted. If you're still using the builder's preview URL (like yoursite.lovable.app), the pixel won't resolve visitors because those URLs run through shared infrastructure that masks visitor identity. Once the site is deployed to your own custom domain on standard hosting (Netlify, Vercel, AWS, etc.), the pixel works normally.

"We installed the pixel on Shopify and resolution is near zero. Why?"

Check where it is installed. If it is under Settings > Customer events as a custom pixel, Shopify runs it in a sandbox without cookie access. Remove it there and add the script to layout/theme.liquid instead. Also confirm that a consent or cookie app is not blocking the script for every visitor.

"Can you track Shopify checkouts and orders?"

Not with the current theme install, because checkout pages don't run theme code. Shopify does send checkout and order events to Customer Events custom pixels, but those run in the same sandbox that drops identity resolution to roughly 3%, so they can record a purchase without identifying who made it. A Delivr Shopify app for checkout and order events is in development. The theme install covers storefront browsing until then.

---

Next Steps

• How Identity Resolution Works -- Understand the cookie-to-person pipeline
• Understanding Resolution Rates -- Why rates vary by browser and traffic mix
• On-Domain Events API -- Install a pixel and query visitor events
• White Label Pixel Setup -- Host the pixel on your own domain