Skip to main content

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.

Data direction: This is a source — data flows into Upstack from this platform for analytics, reporting, and enrichment.
Shopify is your primary data source. Once connected, Upstack installs a lightweight pixel on your storefront to capture real-time visitor events and registers webhooks to receive order, product, and customer updates directly from Shopify’s backend.

​
Prerequisites

Prerequisites:
  • An Upstack Data account (sign up for free)
  • Access to your workspace in the Upstack dashboard
You’ll also need:
  • An active Shopify store on any plan (Basic, Shopify, Advanced, or Plus)
  • Store owner or staff access with permission to install apps

​
Setup

1

Install the Upstack Data app

Visit the Shopify App Store listing for Upstack Data and click Install. Alternatively, in the Upstack dashboard navigate to Integrations → Sources and click Connect Shopify to be redirected to the Shopify install flow.
If your organization manages multiple Shopify stores, you’ll repeat this process for each store. Each store gets its own Pixel ID and appears as a separate source in your Upstack dashboard.
2

Authorize data access

Shopify prompts you to review the permissions Upstack requires:
  • Read products — to sync your product catalog for content ID matching
  • Read orders — to ingest purchase events and revenue data
  • Read customers — to enrich identity resolution with customer profiles
  • Read and write script tags — to install the Upstack tracking pixel on your storefront
Click Install app to grant access. Upstack immediately begins configuring your store connection.
3

Verify the pixel is active

After installation, navigate to Settings → Pixel in the Upstack dashboard. You should see your Shopify store listed with a Connected status and a Pixel ID assigned.Open your Shopify storefront in a browser, browse a product page, and check the Live Event Stream in the Upstack dashboard. Events should appear within 60 seconds.

​
What Data Is Ingested

Shopify provides three categories of data to Upstack:
Data TypeSourceFrequencyKey Fields
Storefront eventsBrowser pixelReal-timePage views, product views, add-to-cart, checkout, purchase
Order dataWebhooksNear real-timeOrder ID, line items, revenue, discounts, shipping, customer info
Product catalogAPI syncEvery 6 hoursProduct ID, title, variants, price, images, inventory status
Customer profilesAPI sync + webhooksNear real-timeEmail, name, address, order history, tags
Upstack also performs a historical backfill of your last 90 days of orders and customer data during initial setup. This gives you attribution data from day one without waiting for new events to accumulate.

​
You’ll Know It’s Working When…

Verification checklist: Complete all items below to confirm your setup is working correctly. If any check fails, see the troubleshooting section below or the relevant troubleshooting guide.
  • Your Shopify store shows Connected status in the Upstack dashboard under Integrations → Sources
  • A Pixel ID is assigned and visible under Settings → Pixel
  • Browsing your storefront generates PageView events in the Live Event Stream within 60 seconds
  • A test order generates a Purchase event with correct revenue and order details

​
Troubleshooting

Check that the pixel is installed correctly by inspecting your storefront’s page source. Search for upstack in the HTML — you should see the pixel script tag in the <head> section.Steps to fix:
  1. Go to Settings → Pixel in the Upstack dashboard and confirm the status is Connected
  2. Open your storefront in an incognito/private browser window (extensions and ad blockers can interfere)
  3. Browse a product page, then check the Live Event Stream
  4. If still no events, go to your Shopify admin → Settings → Customer events and verify the Upstack pixel is listed and enabled
If the pixel is missing from Shopify’s customer events, try uninstalling and reinstalling the Upstack app.
Order data arrives via Shopify webhooks. If orders are missing:
  1. Check Integrations → Sources → Shopify in the Upstack dashboard for any webhook error indicators
  2. Verify your Shopify store hasn’t hit webhook rate limits (common during flash sales)
  3. Confirm the Upstack app still has Read orders permission in your Shopify admin → Settings → Apps and sales channels → Upstack Data
Webhooks that fail are retried automatically by Shopify for up to 48 hours. If data is delayed but eventually arrives, this is normal behavior during high-traffic periods.
The initial backfill of historical orders and customers can take up to 2 hours depending on your store’s volume. Check the Sources tab for a progress indicator.If backfill hasn’t completed after 4 hours, contact support@upstackdata.com with your Pixel ID.
Still stuck? Contact support@upstackdata.com with your Pixel ID and a description of the issue. We typically respond within a few hours.

Shopify Webhooks

How Upstack uses Shopify webhooks for real-time order and customer updates.

Verify Events Are Flowing

Step-by-step guide to confirm your Shopify source is working end-to-end.

Server-Side Tracking

Learn how the Upstack Pixel captures events and why server-side delivery matters.