# Install on Shopify
Source: https://docs.luriart.com/install/shopify
Plain text: https://docs.luriart.com/install/shopify.txt

Install the Luria app on your Shopify store, approve permissions, switch on the app embed, and confirm it is live.

Time needed: 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.

1. Sign in at [luriart.com/app](https://www.luriart.com/app).
2. Enter your store URL (for example `your-store.myshopify.com`) and click **Install**.
3. 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.

[Screenshot: Luria dashboard at luriart.com/app with the store URL field filled in and the Install button highlighted]

### 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.

[Screenshot: Shopify's app permission screen listing the access Luria requests, with the Install app button at the bottom]

**Note:**
  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.

1. In Shopify admin, go to **Online Store > Themes**.
2. On your **live** theme (the one at the top, marked Current), click **Customize**.

[Screenshot: Shopify admin Online Store > Themes page with the Customize button on the current live theme highlighted]

3. In the theme editor, click the **App embeds** icon in the left sidebar (the puzzle-piece icon at the bottom of the icon column).

[Screenshot: Shopify theme editor with the App embeds icon in the left sidebar highlighted]

4. Find **Luria** in the list and switch the toggle on.

[Screenshot: App embeds panel showing the Luria embed with its toggle switched on]

5. Click **Save** in the top right.

[Screenshot: Theme editor Save button in the top right after enabling the Luria embed]

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](/install/verify-install). It takes 2 minutes and runs three checks:

1. **Tracking live:** open your store in a private window, then look for the green dot in your Luria dashboard within about 60 seconds.
2. **Sessions climbing:** the Live tab should count your visit and keep counting as real visitors arrive.
3. **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](/train/goals). Then spend 5 minutes on [How to train Luria](/train/how-to-train) so the first variants sound like you.

## Troubleshooting
  **I can't find the Luria toggle under App embeds**
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](https://www.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](mailto:support@luriart.com)  and we will help you use the snippet instead.

  **I have a custom or heavily edited theme**
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](/install/custom-site) in your theme's `theme.liquid` head instead.

  **I run a headless storefront (Hydrogen or a custom frontend)**
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](/install/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.

  **I have more than one theme**
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.

  **I changed or republished my theme after installing**
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.

  **How do I pause or remove Luria?**
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](/reference/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.

## Next steps
  * [Train Luria](/train/overview)
  * [How to train Luria](/train/how-to-train)
  * [Training timeline](/train/timeline)