Common issues
A symptom to fix list for the problems merchants hit most often, with the page that solves each one.
Start here. Find your symptom in the table, then follow the link. Most fixes take a few minutes.
What you'll need
- Access to your site, or to the Luria app inside your Shopify admin.
- A private browser window with extensions and blockers off.
- About five minutes.
Steps
Step 1: Match your symptom
| Symptom | Likely cause | Where to fix it |
|---|---|---|
| Nothing is being recorded on a non-Shopify site | Tag is not in <head>, site ID is wrong, or the browser is blocking Luria | Snippet not firing |
| Shopify says "Tracking on storefront: Needs activating" | The Luria app embed is off in your live theme | Install on Shopify |
| Your pages look unchanged | Allowance used, changes waiting for approval, embed off, or the test is still gathering sessions | No variants serving |
| Orders are not showing up as conversions | Terms not approved, pixel not reporting, or the order carried no Luria attributes | Orders missing |
| Luria's count is lower than Shopify's | Luria counts attributed orders, net of full refunds; Shopify counts every order | Numbers don't match Shopify |
| One order looks like two conversions | A conversion call on a page that Luria already counts automatically | Duplicates |
| A consent banner appeared on your site | The snippet asks for consent in the EU, UK and Switzerland before tracking anything | Consent |
| Banner reads "Free limit reached, variants paused" | Your 5 free attributed conversions are used | Plans and metering |
| The status pill says "{n} awaiting your approval" | You are in Approve first mode | Approvals |
Step 2: Make the change, then wait about a minute
Serving decisions are cached for up to 60 seconds. After switching the embed on or off, or after Luria pauses or resumes your site, give it about a minute before you judge the result.
Step 3: Retest in a clean window
Open a private window with blockers off and load the page. Your own browser remembers the arm it was assigned, so a normal window will keep showing you the same version.
Verify it worked
On Shopify, open the Luria app in your admin. The Status card should read "App connection: Connected", "Tracking on storefront: Live" and "Data agreement: Accepted".
On other platforms, load your site in a private window and check your browser's network panel for requests to luriart.com. Verify your install walks through it.
Common failures
- A new theme was published without the embed. Luria is not switched on automatically in a new theme, so tracking goes quiet. Switch the Luria embed on in the new theme and save.
- Headless or Hydrogen storefronts. Luria serves through the Shopify theme app embed, so headless storefronts are not supported.
- Single page apps. The snippet runs once per full page load and does not follow in-app route changes. Install it on marketing and sales pages, not inside a logged-in app.
- Testing with an automated browser. Requests from headless and crawler user agents are filtered out, so scripted checks will not appear in your numbers.