Install

Install AnalyticFast on a Shopify storefront

A theme installation measures the Shopify storefront. Treat checkout and payment confirmation as separate surfaces rather than assuming that editing a theme covers the entire purchase flow.

Install on Shopify

Start by adding the website in AnalyticFast and selecting its domain, timezone and currency. These examples use https://t.analyticfast.com; the origin and Site ID shown in your site’s Settings take precedence.

1. Duplicate your current theme so you have a backup. In Online Store → Themes, use the theme menu to open Edit code.
2. Open layout/theme.liquid. Paste the snippet below once immediately before the closing head tag.
3. Save and preview the theme for layout problems, then publish the intended theme. The analytics verification should use your public storefront domain.
4. Check for an existing app, GTM tag or custom script before adding another copy.

<script defer data-website-id="YOUR_SITE_ID" src="https://t.analyticfast.com/js/script.js"></script>

This method does not install a Shopify app, custom pixel, checkout extension or customer-account tracker. Native Shopify checkout is not a supported payment provider adapter in this guide. If you use your own supported external checkout, connect its revenue integration. A custom server order hook needs verified order data and an explicit attribution-ID handoff; the storefront snippet does not provide that hook automatically. Recheck tracking when you replace the active theme.

Verify the published website

1. Replace YOUR_SITE_ID with the ID for this website, then open its public domain in a normal browser. A builder preview, localhost, webdriver or a visit with ?ml_ignore=true may be ignored.
2. In browser Network tools, check https://t.analyticfast.com/js/script.js and the request to /api/event. A downloaded script or a successful HTTP response alone does not prove that an event was accepted.
3. Use Verify installation in AnalyticFast and check the last received event. If none arrives, check the Site ID, allowed hostname, consent configuration, duplicate installations and any blocker. Domain ownership verification is a separate step.

If your site has a Content Security Policy, allow https://t.analyticfast.com in both script-src and connect-src. Do not put tokens, customer email addresses or private keys in the snippet, URLs or goal properties.

Connect your consent choice

If your site uses an analytics consent banner, use the pending-consent snippet and connect its Accept and Decline/withdraw actions. Pending mode sets no analytics cookies; it still records visits using the collector’s cookie-free identity mode. A consent manager that blocks the tag entirely prevents those requests. Choose the collection behavior appropriate for your site; pending mode is not a promise of legal compliance.

<script defer data-website-id="YOUR_SITE_ID" data-consent="pending" src="https://t.analyticfast.com/js/script.js"></script>

// In your existing banner handlers:
window.analyticfast?.('consent', true);  // Accept
window.analyticfast?.('consent', false); // Decline or withdraw

Restore a stored choice on later visits. See the consent implementation guide for the full state and identity behavior.

Official platform references

• Shopify theme code editing
• Shopify theme layouts

Instructions reviewed against the repository and official platform documentation on October 31, 2026. Screenshots are reserved placeholders; no live platform installation is claimed here.

Add your website to get its Site ID and installation checklist. Once visits arrive, connect your payment provider.