> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datalyr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install on Shopify

> Connect orders and turn on storefront and checkout tracking.

The Shopify connection has two parts: the source imports commerce activity, and the storefront install captures the visit that caused it. Complete both.

## Before you start

You need access to the Shopify admin, permission to install apps, and your permanent `myshopify.com` domain. Use that domain even if customers visit a custom domain.

## Connect Shopify

<Steps>
  <Step title="Open Sources">
    In Datalyr, open **Sources**, find **Shopify**, and select **Connect**.
  </Step>

  <Step title="Enter the shop domain">
    Enter `mystore` or `mystore.myshopify.com`. Datalyr redirects you to Shopify Admin.
  </Step>

  <Step title="Authorize the connection">
    Review the requested access and complete the Shopify authorization.
  </Step>

  <Step title="Install the Web Pixel">
    Back in Datalyr, select **Install pixel** if the Shopify Web Pixel is not already marked installed. This covers checkout activity that the theme cannot see.
  </Step>

  <Step title="Enable the App Embed">
    Open the theme editor from the setup prompt. In **App embeds**, turn on **Datalyr**, select **Save**, then visit the storefront once.
  </Step>
</Steps>

<Warning>
  Orders can import even when the App Embed is off. In that state, revenue exists but storefront visits, click IDs, and ad attribution are incomplete.
</Warning>

## What Shopify sends

The connection supports customers, checkouts, paid and fulfilled orders, cancellations, and refunds. The storefront install adds page views, visitor identity, campaign parameters, and click IDs. Datalyr uses those signals to join the order to the earlier visit.

## Verify the setup

1. Open the storefront in a private window with a test UTM URL.
2. Browse a product and begin checkout.
3. In **Events**, confirm a storefront `pageview` appears.
4. Use Shopify's supported test-payment flow to place an order.
5. Confirm the paid order has an order ID, amount, currency, and customer data.
6. Open the customer in **Users** and verify the storefront visit and order share a journey.

## Common failures

* **Store is connected but no storefront events:** turn on the Datalyr App Embed and save the theme.
* **Storefront works but checkout is missing:** return to the Shopify source and install the Web Pixel.
* **Shop domain is rejected:** use the permanent `myshopify.com` subdomain, without a protocol or path.
* **Orders appear without attribution:** test a new order after enabling the embed; historical orders cannot recreate a missing browser visit.
* **Duplicate page views:** remove any separately pasted Datalyr snippet from the Shopify theme when the App Embed owns storefront tracking.

Next, review [ecommerce revenue](/revenue/ecommerce) or follow the full [Shopify use case](/use-cases/shopify).