Overview

Shopify adapter: post-purchase rollout

Use this guide after payment to take the Shopify extension package from ZIP download to storefront verification.

• Download `platform-cookie-core.zip`.
• Copy `packages/adapters/shopify/theme-app-extension/` into your Shopify extension workspace.
• Register the production storefront hostname in billing.
• Enable the Cookiezy embed block in the theme editor.
• Validate homepage, product, collection, cart, and policy page behavior.

Developer documentation screenshot for the Cookiezy Shopify adapter showing the theme app extension and storefront embed flow. — Shopify technical reference: extension package, embed block, and storefront verification path.

Step 1

Prepare the Shopify extension package

Keep the Shopify package intact because the Liquid block references the asset names directly.

Code snippet

packages/adapters/shopify/theme-app-extension/assets/cookie-consent-shopify-loader.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent-ui.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent-scanner.js
packages/adapters/shopify/theme-app-extension/assets/cookie-consent.css
packages/adapters/shopify/theme-app-extension/assets/shopify-customer-privacy-bridge.js
packages/adapters/shopify/theme-app-extension/blocks/cookiezy-embed.liquid

Step 2

Add site key and verify URL to the embed block config

The embed block must pass the production site key and verification endpoint so the storefront can confirm the account and hostname before loading in normal mode.

Code snippet

window.CookiezyConfig = {
  locale: "en",
  policyUrl: "/en/cookie-policy",
  siteKey: "pk_live_cookiezy_demo",
  verifyUrl: "https://cookiezy.com/api/licensing/verify",
  shopify: {
    assets: {
      coreUrl: "{{ 'cookie-consent.js' | asset_url }}",
      uiUrl: "{{ 'cookie-consent-ui.js' | asset_url }}",
      scannerUrl: "{{ 'cookie-consent-scanner.js' | asset_url }}",
      bridgeUrl: "{{ 'shopify-customer-privacy-bridge.js' | asset_url }}"
    }
  }
};

Step 3

Deploy and enable the embed block

Deploy the theme app extension, then enable `cookiezy-embed` in the active theme through the theme customizer.

• Enable the block once per active theme.
• Check that the stylesheet and loader are present in theme preview.
• Keep policy route and locale aligned with the storefront language.

Step 4

Run the storefront test checklist

Always test in theme preview or a clean session before publishing the live store changes.

• Homepage shows the banner on first visit.
• Product and cart pages do not leak optional tracking before consent.
• Reject optional blocks analytics and marketing categories.
• Policy page audit renders and reflects the current state after re-scan.
• `/api/licensing/verify` returns `allowed: true` for the storefront hostname.

packages/adapters/shopify/theme-app-extension/assets/cookie-consent-shopify-loader.js packages/adapters/shopify/theme-app-extension/assets/cookie-consent.js packages/adapters/shopify/theme-app-extension/assets/cookie-consent-ui.js packages/adapters/shopify/theme-app-extension/assets/cookie-consent-scanner.js packages/adapters/shopify/theme-app-extension/assets/cookie-consent.css packages/adapters/shopify/theme-app-extension/assets/shopify-customer-privacy-bridge.js packages/adapters/shopify/theme-app-extension/blocks/cookiezy-embed.liquid

window.CookiezyConfig = { locale: "en", policyUrl: "/en/cookie-policy", siteKey: "pk_live_cookiezy_demo", verifyUrl: "https://cookiezy.com/api/licensing/verify", shopify: { assets: { coreUrl: "{{ 'cookie-consent.js' | asset_url }}", uiUrl: "{{ 'cookie-consent-ui.js' | asset_url }}", scannerUrl: "{{ 'cookie-consent-scanner.js' | asset_url }}", bridgeUrl: "{{ 'shopify-customer-privacy-bridge.js' | asset_url }}" } } };