> ## 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 > Install the Upstack Data app in Shopify step by step: connect your store, enable the theme app extension, add the custom pixel, set privacy, and verify events. > [!NOTE] > > **New to Upstack?** If you haven't already, [create your Upstack account](https://docs.upstackdata.com/quickstart/create-an-account.md) before continuing. > [!TIP] > > * Sign up for Upstack Data and choose your plan > * Connect Shopify from the Upstack dashboard (System → Data Sources) > * 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 ## 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. Shopify tracking uses two components, and both are required: * The **theme app extension** (Part 2) captures storefront browsing, such as page, product, and collection views. * The **Upstack custom pixel** (Part 3) captures cart and checkout activity through Shopify's Customer Events. The custom pixel is not an alternative to the theme app extension. See [Tracking Methods](https://docs.upstackdata.com/sources/catalog/shopify-automatic-tracking.md#tracking-methods) for what each one captures. ## Prerequisites * Active Upstack Data account ([sign up](https://app.upstackdata.com/signup)) — [see plans and pricing](https://docs.upstackdata.com/billing/plans-and-pricing.md) * 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), open **System → Data Sources**, and click **Connect Shopify**. Upstack redirects you to your Shopify Admin to authorize the install. Connecting from the dashboard links your Upstack Pixel ID to the store during the install. Help guide to complete this step: [How to Install the Upstack Data App in Shopify →](https://docs.upstackdata.com/sources/catalog/shopify/how-to-download-and-install-upstack-data-app-in-shopify.md) > [!NOTE] > > **Setting the app up again?** If you installed Upstack Data before and the app doesn't show the login form or setup flow, check the Upstack Data app settings for an **Always Show Login Form** option. If you see it, enable it, then log out and back in. If the setup flow still doesn't appear, contact support. ### Part 2: Enable Theme App Extension **1. Open the theme settings prompt** After signing in to the Upstack Data app, a modal window will prompt you to **enable** the Upstack Data Theme App Extension. Click **Enable Upstack Data Theme App Extension**. ![Modal prompt to enable the Upstack Data Theme App Extension](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) **2. Enable the Theme App Extension in Shopify Admin** In Shopify Admin, ensure the **Upstack Data Theme App Extension is ENABLED**. Help guide to complete this step: [How to Ensure Upstack Data Theme App Extension is Enabled →](https://docs.upstackdata.com/sources/catalog/shopify/how-to-ensure-upstack-data-theme-app-extension-is-enabled.md) **3. Proceed to onboarding** Click **Continue** to proceed with the onboarding. App embeds are turned on per theme. If you publish a different theme later, enable the Upstack app embed on that theme too. ### Part 3: Add Custom Pixel **1. 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. ![Copy Pixel Code button in the Upstack Data onboarding page](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) **2. Add a Custom Pixel in Shopify Admin** In your [Shopify Admin](https://admin.shopify.com), navigate to **Settings → Customer events → Add custom pixel**. ![Shopify Admin Customer events page with Add custom pixel option](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) **3. Name the Custom Pixel** Set the pixel name to **UpstackData** → click **Add pixel**. ![Naming the custom pixel UpstackData in Shopify Admin](https://mintcdn.com/upstackdata-afbed50d/VkKgD3LCNMawEk9D/images/image-1.png?fit=max\&auto=format\&n=VkKgD3LCNMawEk9D\&q=85\&s=018d5f9992319f927bf4304b0ec48fbb) ### Part 4: Connect Shopify Customer Events Pixel **1. Set consent and privacy settings** Help guide to complete this step: [How to Set Up Upstack Custom Pixel Privacy Settings →](https://docs.upstackdata.com/sources/catalog/shopify/how-to-setup-upstack-custom-pixel-privacy-settings.md) **2. Paste the Pixel Code** Paste the **Pixel Code →** click **Save →** click **Connect**. ![Paste pixel code, save, and connect in Shopify Customer events](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) **3. Connect the Custom Pixel** In the modal popup, click **Connect**. ![Connect button in the Shopify custom pixel confirmation modal](https://mintcdn.com/upstackdata-afbed50d/r7kPU9Z0Ocj96UFU/images/intercom/c8dfdf99786492c8.jpeg?fit=max\&auto=format\&n=r7kPU9Z0Ocj96UFU\&q=85\&s=409ee728d851a78db02064319feeaa13) ### Part 5: Finish setup In the **Upstack Data app**, click **Continue** → then click **Finish Setup**. ![Finish Setup button in the Upstack Data app onboarding](https://mintcdn.com/upstackdata-afbed50d/40dgTTn1PLjePhJa/images/intercom/fbfb4769f55e9013.png?fit=max\&auto=format\&n=40dgTTn1PLjePhJa\&q=85\&s=0d3e524ccffb06d2e4f103e94ae4acb3) ### 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 **System → Events Manager** 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 **Upstack Data** is enabled. For a full verification walkthrough, see [Complete Guide to Troubleshooting Your Upstack Data Tracking Pixel](https://docs.upstackdata.com/troubleshooting/complete-guide-to-troubleshooting-your-upstack-data-tracking-pixel.md). > [!NOTE] > > **Need help?** > > If you encounter any issues during setup, contact our support team and we'll help diagnose the problem. ## What's next > [card] [Connect a destination](https://docs.upstackdata.com/quickstart/connect-a-destination.md) > > Forward events to Meta CAPI, TikTok, Klaviyo, or other ad platforms. > [card] [Explore the CLI](https://docs.upstackdata.com/cli/install.md) > > Query your data and manage dashboards from the command line or through AI agents. > [card] [View plans and pricing](https://docs.upstackdata.com/billing/plans-and-pricing.md) > > See available plans and adjust your subscription as your store scales. > [card] [Pages outside Shopify](https://docs.upstackdata.com/resources/implementing-upstack-data-on-landing-pages.md) > > Add the Upstack Pixel to landing pages, subdomains, and page-builder pages such as Replo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.