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

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

## Prerequisites

* Active Upstack Data account ([sign up](https://app.upstackdata.com/signup))

* 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/40dgTTn1PLjePhJa/images/intercom/f344439ecbba8959.png?fit=max&auto=format&n=40dgTTn1PLjePhJa&q=85&s=cef73062a8e35d65464b3e39b55d2d71" alt="" width="612" height="507" data-path="images/intercom/f344439ecbba8959.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**.

    <img src="https://mintcdn.com/upstackdata-afbed50d/r7kPU9Z0Ocj96UFU/images/intercom/abb50430ad274627.png?fit=max&auto=format&n=r7kPU9Z0Ocj96UFU&q=85&s=f9c5281bf61c5b5651cce39c25dfa9be" alt="" width="601" height="505" data-path="images/intercom/abb50430ad274627.png" />
  </Step>

  <Step title="Copy the Pixel Code">
    Click the **Copy Pixel Code** button to copy the code to your clipboard.

    <img src="https://mintcdn.com/upstackdata-afbed50d/r7kPU9Z0Ocj96UFU/images/intercom/a46af0fffa6abb03.png?fit=max&auto=format&n=r7kPU9Z0Ocj96UFU&q=85&s=f2e371951df35b51d71ab4e9f3f98fcd" alt="" width="607" height="501" data-path="images/intercom/a46af0fffa6abb03.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/a7q81tQDxtvowAUn/images/intercom/13af2b7e9570905e.jpeg?fit=max&auto=format&n=a7q81tQDxtvowAUn&q=85&s=3e50cef6d2b301953d019d7b3896c03e" alt="" width="1120" height="652" data-path="images/intercom/13af2b7e9570905e.jpeg" />

    <img src="https://mintcdn.com/upstackdata-afbed50d/r7kPU9Z0Ocj96UFU/images/intercom/ccebe420ee74b55d.jpeg?fit=max&auto=format&n=r7kPU9Z0Ocj96UFU&q=85&s=3701d74e9e95aff20a119491c2c7cae5" alt="" width="1120" height="595" data-path="images/intercom/ccebe420ee74b55d.jpeg" />
  </Step>

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

    <img src="https://mintcdn.com/upstackdata-afbed50d/r7kPU9Z0Ocj96UFU/images/intercom/6df091080d977b6f.jpeg?fit=max&auto=format&n=r7kPU9Z0Ocj96UFU&q=85&s=b7b2f9ff7ff8fd698d905866dbc97a99" alt="" width="1120" height="595" data-path="images/intercom/6df091080d977b6f.jpeg" />
  </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/a7q81tQDxtvowAUn/images/intercom/4b2a6666977e9215.jpeg?fit=max&auto=format&n=a7q81tQDxtvowAUn&q=85&s=9ddbf7b8577d6d0566485f894157366c" alt="" width="1120" height="625" data-path="images/intercom/4b2a6666977e9215.jpeg" />

    <img src="https://mintcdn.com/upstackdata-afbed50d/a7q81tQDxtvowAUn/images/intercom/0c089fc5d4ab01f0.jpeg?fit=max&auto=format&n=a7q81tQDxtvowAUn&q=85&s=865548930e1997c2c59733718537abf6" alt="" width="1120" height="625" data-path="images/intercom/0c089fc5d4ab01f0.jpeg" />
  </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="" 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="" 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>