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

# Complete How-To Guide for Setting Up the Upstack Data App in Shopify

> This is guide is a step-by-step instructions to installing and setting up the Upstack Data app in Shopify for accurate tracking & reporting.

<Info>
  **New to Upstack?** If you haven't already, [create your Upstack account](/get-started/create-an-account) before continuing.
</Info>

<Tip>
  * Sign up for Upstack Data and choose your plan
  * Connect Shopify from the Upstack dashboard (Data Sources → Shopify)
  * Enable Theme App Extension
  * Add Upstack Data Custom Pixel
  * Set Consent and Privacy Settings for the Upstack Data Custom Pixel
  * Connect Shopify Customer Events Pixel
  * Finish setup
  * Verify events
</Tip>

## Overview

**Upstack Data** is a first-party data pixel (CAPI) solution that enhances your Facebook (Meta), TikTok Ads, Google Ads, and Klaviyo tracking capabilities, helping you bypass iOS 14+ restrictions and improve your advertising ROAS.

## Prerequisites

* Active Upstack Data account ([sign up](https://app.upstackdata.com/signup)) — [see plans and pricing](/billing/plans-and-pricing)
* Active Shopify store (`your-store.myshopify.com`)
* [Shopify Admin](https://admin.shopify.com) access with permission to install apps and edit themes
* Facebook Business Manager account and admin access (for Meta tracking)
* Ad account credentials and access for every platform you want to track

## Configuration steps

### Part 1: Connect Shopify from the Upstack dashboard

Sign in to [app.upstackdata.com](https://app.upstackdata.com), navigate to **Data Sources → Shopify**, and click **Connect Shopify**. Upstack redirects you to your Shopify Admin to authorize the install.

{/* TODO: Add screenshot of Shopify install permissions page */}

Help guide to complete this step:

[How to Install the Upstack Data App in Shopify →](/guides/shopify/how-to-download-and-install-upstack-data-app-in-shopify)

### Part 2: Enable Theme App Extension

<Steps>
  <Step title="Open the theme settings prompt">
    After signing in to the Upstack Data app, a modal window will prompt you to **enable** the UpStackified Theme App Extension.

    Click **Enable UpStackified Theme App Extension**.

    <img src="https://mintcdn.com/upstackdata-afbed50d/T0pjM_griH4tgZ3x/images/intercom/shopify-setup-enable-theme-app-extension.png?fit=max&auto=format&n=T0pjM_griH4tgZ3x&q=85&s=7cd7c35893f707f1d1201c51d322a46b" alt="Modal prompt to enable the UpStackified Theme App Extension" style={{ width:"79%" }} width="669" height="554" data-path="images/intercom/shopify-setup-enable-theme-app-extension.png" />
  </Step>

  <Step title="Enable the Theme App Extension in Shopify Admin">
    In Shopify Admin, ensure the **UpStackified Theme App Extension is ENABLED**.

    Help guide to complete this step:

    [How to Ensure Upstack Data Theme App Extension is Enabled →](/guides/shopify/how-to-ensure-upstack-data-theme-app-extension-is-enabled)
  </Step>

  <Step title="Proceed to onboarding">
    Click **Continue** to proceed with the onboarding.
  </Step>
</Steps>

### Part 3: Add Custom Pixel

<Steps>
  <Step title="Open Customer Events in the Upstack Data app">
    On the Upstack Data app onboarding page, click **Customer events** and click the **Copy Pixel Code** button to copy the code to your clipboard.

    <img src="https://mintcdn.com/upstackdata-afbed50d/T0pjM_griH4tgZ3x/images/intercom/shopify-setup-copy-pixel-code.png?fit=max&auto=format&n=T0pjM_griH4tgZ3x&q=85&s=f90078aa4ef6b13698a4f70abb24f3e6" alt="Copy Pixel Code button in the Upstack Data onboarding page" style={{ width:"62%" }} width="639" height="840" data-path="images/intercom/shopify-setup-copy-pixel-code.png" />
  </Step>

  <Step title="Add a Custom Pixel in Shopify Admin">
    In your [Shopify Admin](https://admin.shopify.com), navigate to **Settings → Customer events → Add custom pixel**.

    <img src="https://mintcdn.com/upstackdata-afbed50d/T0pjM_griH4tgZ3x/images/intercom/shopify-setup-customer-events-add-pixel.png?fit=max&auto=format&n=T0pjM_griH4tgZ3x&q=85&s=cd33d8b3501f410bd148b9f985570be6" alt="Shopify Admin Customer events page with Add custom pixel option" style={{ width:"63%" }} width="738" height="368" data-path="images/intercom/shopify-setup-customer-events-add-pixel.png" />
  </Step>

  <Step title="Name the Custom Pixel">
    Set the pixel name to **UpstackData** → click **Add pixel**.

    <img src="https://mintcdn.com/upstackdata-afbed50d/VkKgD3LCNMawEk9D/images/image-1.png?fit=max&auto=format&n=VkKgD3LCNMawEk9D&q=85&s=018d5f9992319f927bf4304b0ec48fbb" alt="Naming the custom pixel UpstackData in Shopify Admin" title="Name the custom pixel" style={{ width:"54%" }} width="619" height="346" data-path="images/image-1.png" />
  </Step>
</Steps>

### Part 4: Connect Shopify Customer Events Pixel

<Steps>
  <Step title="Set consent and privacy settings">
    <Warning>
      **Upstack Data does not sell any data.** We are a privacy-first solution and committed to adhering to the regulations for each jurisdiction.
    </Warning>

    Help guide to complete this step:

    [Shopify Custom Pixel - Privacy Consent Settings →](/guides/shopify/shopify-custom-pixel-privacy-consent-settings)
  </Step>

  <Step title="Paste the Pixel Code">
    Paste the **Pixel Code →** click **Save →** click **Connect**.

    <img src="https://mintcdn.com/upstackdata-afbed50d/T0pjM_griH4tgZ3x/images/intercom/shopify-setup-paste-pixel-code.png?fit=max&auto=format&n=T0pjM_griH4tgZ3x&q=85&s=9b1e2b73d727b73dc8cf7472222f215a" alt="Paste pixel code, save, and connect in Shopify Customer events" width="794" height="867" data-path="images/intercom/shopify-setup-paste-pixel-code.png" />
  </Step>

  <Step title="Connect the Custom Pixel">
    In the modal popup, click **Connect**.

    <img src="https://mintcdn.com/upstackdata-afbed50d/r7kPU9Z0Ocj96UFU/images/intercom/c8dfdf99786492c8.jpeg?fit=max&auto=format&n=r7kPU9Z0Ocj96UFU&q=85&s=409ee728d851a78db02064319feeaa13" alt="Connect button in the Shopify custom pixel confirmation modal" width="1120" height="595" data-path="images/intercom/c8dfdf99786492c8.jpeg" />
  </Step>
</Steps>

### Part 5: Finish setup

In the **Upstack Data app**, click **Continue** → then click **Finish Setup**.

<img src="https://mintcdn.com/upstackdata-afbed50d/40dgTTn1PLjePhJa/images/intercom/fbfb4769f55e9013.png?fit=max&auto=format&n=40dgTTn1PLjePhJa&q=85&s=0d3e524ccffb06d2e4f103e94ae4acb3" alt="Finish Setup button in the Upstack Data app onboarding" width="1120" height="595" data-path="images/intercom/fbfb4769f55e9013.png" />

### Part 6: Verify the installation

Confirm everything is wired up correctly before you start running ads:

* Place a test order on your store (or wait for a real one).
* In the [Upstack dashboard](https://app.upstackdata.com), open **Event Health** and confirm `PageView`, `AddToCart`, `InitiateCheckout`, and `Purchase` events are arriving.
* In [Shopify Admin → Settings → Customer events](https://admin.shopify.com), confirm the **UpstackData** Custom Pixel shows status **Connected**.
* In [Shopify Admin → Online Store → Themes → Customize → App embeds](https://admin.shopify.com), confirm **UpStackified Pixel** is enabled.

<Note>
  **Need help?**

  If you encounter any issues during setup, contact our support team and we'll help diagnose the problem.
</Note>

## What's next

<CardGroup cols={2}>
  <Card title="Connect a destination" icon="plug" href="/get-started/connect-a-destination">
    Forward events to Meta CAPI, TikTok, Klaviyo, or other ad platforms.
  </Card>

  <Card title="Explore the CLI" icon="terminal" href="/cli/install">
    Query your data and manage dashboards from the command line or through AI agents.
  </Card>

  <Card title="View plans and pricing" icon="credit-card" href="/billing/plans-and-pricing">
    See available plans and adjust your subscription as your store scales.
  </Card>

  <Card title="Troubleshoot issues" icon="wrench" href="/troubleshooting/pixel-stuck-on-waiting-for-first-events">
    Common fixes if events aren't appearing after setup.
  </Card>
</CardGroup>