Install on Shopify
Install the Luria app on your Shopify store, approve permissions, switch on the app embed, and confirm it is live.
About 8 minutes
What you'll need
- 2 minutes to read this page, about 8 to do it
- Shopify admin access: the store owner, or a staff account with the Apps and Themes permissions
- No code and no theme edits; Luria never touches your theme files
Step 1: Install the Luria app from your direct link
Luria is not in the Shopify App Store. You install it from your Luria account instead.
- Sign in at luriart.com/app.
- Enter your store URL (for example
your-store.myshopify.com) and click Install. - If we sent you an install link by email, clicking that link does the same thing.
This is the correct and only way to install Luria on Shopify. You will land on a standard Shopify permission screen inside your own store's admin, the same screen you see when installing any app.
Step 2: Approve permissions
Shopify shows you what Luria is asking to read. Here is what each item is for, in plain terms.
| Luria reads | So it can |
|---|---|
| Store information | Set up your account and match your currency and timezone |
| Products and collections | Write copy that matches what you actually sell |
| Orders | Count conversions and revenue and measure lift. Luria never sees card numbers or payment details |
| Customer events (web pixel) | Know which version of a page a buyer saw before they purchased |
| Theme app embed | Show page variants without editing your theme code |
Click Install app (Shopify's button) to approve. You are sent back to your Luria dashboard.
Billing
Billing is handled by Luria directly with a card on file at luriart.com. Nothing appears on your Shopify bill. Your first 5 attributed conversions are free.
Step 3: Enable the Luria embed
Luria serves page variants through a theme app embed. The install flow tries to switch it on for you. If it could not, your Luria dashboard shows a one-click Activate link that opens the exact spot in your theme editor. Either way, here is how to do it by hand.
- In Shopify admin, go to Online Store > Themes.
- On your live theme (the one at the top, marked Current), click Customize.
- In the theme editor, click the App embeds icon in the left sidebar (the puzzle-piece icon at the bottom of the icon column).
- Find Luria in the list and switch the toggle on.
- Click Save in the top right.
That is the whole theme step. Luria did not add or change a single line of your theme code; the embed sits beside your theme and can be switched off the same way.
Step 4: Confirm it's live
Go to Verify your install. It takes 2 minutes and runs three checks:
- Tracking live: open your store in a private window, then look for the green dot in your Luria dashboard within about 60 seconds.
- Sessions climbing: the Live tab should count your visit and keep counting as real visitors arrive.
- First variant served: appears within a few hours once Baseline is underway; up to 3 days on low-traffic stores.
Step 5: Set your goal
Tell Luria what to optimize for. On most Shopify stores that is purchases, and Luria counts them straight from your orders. Go to Set your goal. Then spend 5 minutes on How to train Luria so the first variants sound like you.
Troubleshooting
Check these in order:
- Wrong theme selected. App embeds are per theme. Make sure you clicked Customize on your live theme, not a draft or a copy.
- Theme not published. If you are editing an unpublished theme, enable the embed there too, but the live store only uses the published one.
- App not installed. Go back to luriart.com/app and confirm your store shows as connected. If not, repeat Step 1.
- Older theme. App embeds need an Online Store 2.0 theme. Most themes from the last few years qualify. If yours is older, update the theme or ask us at support@luriart.com and we will help you use the snippet instead.
That is fine. The app embed does not depend on your theme's code; it loads beside it. Enable it as in Step 3. If your theme was built without Online Store 2.0 sections, use the universal snippet from Install on a custom site in your theme's theme.liquid head instead.
The theme app embed cannot apply to a headless storefront because there is no Shopify theme rendering your pages. Use the universal snippet from Install on a custom site in your storefront's head instead.
Limits to know about: purchases are still counted from Shopify orders through the app (install the app in Step 1 and Step 2 as normal), but variant serving and session tracking depend on the snippet loading on every page of your frontend. If your checkout runs on Shopify and your pages run elsewhere, that is supported.
The embed is per theme. Enable it on the live theme. When you publish a new theme, open that theme's editor and switch the Luria embed on again, then Save. Until you do, Luria keeps tracking but stops serving variants on the new theme.
Re-toggle the embed on the new live theme (Step 3). Luria alerts you in the dashboard when the embed goes quiet on your live theme. Your training and results carry over; nothing resets.
Pause from the Luria dashboard, switch the embed off, or uninstall the app. Any of these stops all page changes within about 60 seconds. See Uninstall.
Works alongside
Luria is built to sit next to the apps you already run. It reads its own events and nothing else.
| App | Notes |
|---|---|
| Klaviyo | No conflict. Luria does not touch your flows, forms, or email events |
| Recharge | No conflict. Subscription checkouts are counted as Shopify orders like any other |
| PageFly | No conflict. Luria serves variants on top of PageFly pages the same way it does on theme pages |
| BetterCart | No conflict. Luria does not change cart behavior |
| Hyros | No conflict. Luria never fires conversions into Hyros or reads its data |
| Elevar | No conflict. Elevar's data layer and tags are untouched |
| Triple Whale | No conflict. Triple Whale's pixel and Luria's pixel run side by side |
Luria does not conflict with attribution tools and does not double-fire conversions. On Shopify, a purchase is counted once, from the order itself, never from anything on the page. Your attribution numbers in those tools stay exactly as they were.