Install on a custom site
Install the Catail tracker on a non-Shopify site. Consent is collected by the Catail-owned banner bundled with the tracker. Time: ~10 minutes.
What you are connecting
There is no Shopify Web Pixel or order webhook on custom sites. Commerce funnel features that depend on Shopify checkout are not available.
| Component | What it does |
|---|---|
| Site tracker snippet | One script before </body> — loads analytics and the consent banner |
| Consent banner | First-visit modal; placement configurable in Counter → Settings |
1. Copy the tracker snippet
- Open [Catail merchant console](https://ai.catail.xyz) → your project → Counter.
- Use Install with an AI coding agent (recommended) or expand Install manually.
- Copy the site tracker snippet.
2. Paste before </body>
Do not block the script URL in your Content-Security-Policy. The AI install prompt lists required connect-src and script-src origins.
- Open your site's root layout or template.
- Paste the snippet immediately before </body>.
- Deploy or publish.
3. Configure consent banner display
- Merchant console → Counter → Settings → Consent banner display.
- Choose placement: Floating corner, Footer inline, or Link triggered (you add a footer/menu link).
4. Verify
- Open the site in a private window.
- Confirm the Catail consent modal appears before analytics runs.
- Accept analytics and browse a page.
- In Counter, confirm Receiving events = Yes and Consent mode = Production (Catail consent banner).
Consent categories
All toggles are off by default on the customize layer until the visitor opts in.
| Toggle | Gates |
|---|---|
| Analytics | Behavior measurement (pointer, scroll, heatmap inputs) |
| Preferences | Future personalization features |
| Marketing | Stored for future ad-related features; not used for measurement today |