Shopify Integration

Last updated: July 1, 2026

Use this page for Shopify storefronts that need CYBEXO Runtime Suite.

CYBEXO supports Shopify through the standard web runtime. When a managed Shopify app/embed is enabled for your account, use that path. If a managed embed is not available, use the direct storefront script path below.

1. Requirements

Shopify Online Store theme access.
Valid CYBEXO Settings ID.
Permission to edit theme custom code or enable app embeds.

2. Recommended Integration Paths

Use one path per storefront:

Managed CYBEXO Shopify embed, when available for your account.
Direct CYBEXO Web CMP Engine script in the storefront theme.

Do not run both on the same storefront.

3. Direct Storefront Script

Add the loader once in the theme layout before ordinary marketing or analytics tags where possible.

<script
  id="cybexo-cmp"
  src="https://cmp.cybexo.com/loader.js"
  data-settings-id="YOUR_SETTINGS_ID">
</script>

4. Customer Privacy API

For Shopify consent synchronization, confirm the storefront exposes:

typeof window.Shopify?.customerPrivacy?.setTrackingConsent

When using a managed CYBEXO Shopify integration, CYBEXO maps CMP choices to Shopify consent categories according to your account configuration.

5. Verification

On the storefront:

document.getElementById("cybexo-cmp")

performance.getEntriesByType("resource").filter(r => r.name.includes("cmp.cybexo.com/loader.js"))

(window.dataLayer || []).filter(x => x && x[0] === "consent" && (x[1] === "default" || x[1] === "update"))

window.Shopify?.customerPrivacy?.currentVisitorConsent?.()

Run Pulse after publishing. The report should show CYBEXO runtime installed, loader verified, and Consent Mode evidence where applicable.

6. Debug Mode

Use the CYBEXO debug overlay on the storefront:

https://example.myshopify.com/?cybexo_debug_ui=1

7. Common Issues

Issue	Likely cause	Fix
Duplicate banner	Managed embed and direct script both enabled	Keep one integration path
Loader missing	Theme section did not publish or app embed disabled	Confirm theme publish state
Consent Mode defaults missing	Loader runs after Google tags	Move loader earlier or use GTM template
Shopify categories not updating	Customer Privacy API unavailable or unmanaged direct script	Confirm managed integration requirements