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

# How to Set up Upstack Data on a Landing Page or Subdomain

> Install the Upstack Data Pixel on a landing page or subdomain by adding the script with your Pixel ID into the page's head — enabling tracking and attribution for non-Shopify domains.

***

# **Quick Summary**

* **Copy your Pixel ID** from the [Upstack dashboard](https://app.upstackdata.com).

* **Insert the Pixel ID** into the script below.

* Place the script **inside the `<head>` section** of your webpage.

* **Publish** or **update** your landing page.

* **Verify** your installation.

***

# **Prerequisites**

* An [Upstack Data](https://app.upstackdata.com) account with the Upstack Data app installed on your Shopify store.

* Your Upstack Pixel ID (UUID format: `XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`, e.g., `58284d43-85f6-41fb-b2e0-f32f8ecb4e9b`). See [How to find my Upstack Data Pixel ID](/resources/how-to-find-my-upstack-data-pixel-id).

* Edit access to the landing page or subdomain (admin access in the page builder, CMS, or static host).

* Ability to add code to the `<head>` section (Custom Code / Header Code area in your tool).

***

# **Configuration Steps**

## **Step 1: Find and copy your Upstack Pixel ID**

Your **Upstack Pixel ID** is a unique identifier linked to your Shopify store. This ID is used to track browser events and associate them with your account.

For step-by-step instructions on locating your Upstack Pixel ID, see:

[How to find my Upstack Data Pixel ID?](/resources/how-to-find-my-upstack-data-pixel-id)

***

## **Step 2: Insert your Pixel ID into the script**

* Open the Upstack Pixel script provided below.

* Replace the placeholder Pixel ID with your own ID.

### Upstack Pixel Snippet

```html theme={null}
<!-- Start UpstackData Pixel -->
<script src="https://prod2-cdn.upstackified.com/scripts/px/ups.min.js" async="true"></script>
<script>
  window._adqLoaded = 0;
  window._upsqueue = window._upsqueue || [];
  window._upstack = window._upstack || function () {
    window._upsqueue.push(arguments);
  };
  window._upstack('init', 'XXXX-XXXX-XXXXX-XXXX'); // replace with your Pixel ID
  window._upstack('page');
</script>
<!-- End UpstackData Pixel -->

<!-- Start script to add current query string to all links -->
<script>
  // Function to add current page's query string to all links
  function addCurrentQueryStringToLinks() {
    // Get the current page's query string
    var currentQueryString = window.location.search.slice(1);
    // If there's no query string, exit the function
    if (!currentQueryString) return;
    // Get all 'a' elements in the document
    var links = document.getElementsByTagName('a');
    // Loop through each link
    for (var i = 0; i < links.length; i++) {
      var link = links[i];
      var href = link.href;
      // Skip links that are just anchors
      if (href.startsWith('#')) continue;
      // Check if the link already has query parameters
      if (href.indexOf('?') !== -1) {
        // If it does, append the current query string with an '&'
        href += '&' + currentQueryString;
      } else {
        // If it doesn't, append the current query string with a '?'
        href += '?' + currentQueryString;
      }
      // Set the modified href back to the link
      link.href = href;
    }
  }

  // Call this function when the page loads
  window.addEventListener('load', addCurrentQueryStringToLinks);
</script>
<!-- End script to add current query string to all links -->
```

<Note>
  **Important:**

  * **Replace `XXXX-XXXX-XXXXX-XXXX` with the Pixel ID** you obtained in Step 1 (UUID format: `XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX`).

  * Enter the Pixel ID exactly as provided — extra whitespace or quotation mismatches will break tracking.
</Note>

***

## **Step 3: Add the script to your landing page**

* Open the landing page editor or HTML settings of your third-party tool.

* Locate the **Custom Code** or **Header Code** section.

* Paste the complete script into the `<head>` section of the page.

***

## **Step 4: Publish or update your landing page**

* Save and republish the page so the script goes live.

***

## **Step 5: Verify the installation**

* Visit your landing page in a browser.

* Use the [Upstack Data Pixel Helper](/guides/shopify/how-to-install-upstack-data-pixel-helper) to confirm the pixel is firing correctly with your Pixel ID.

* In the [Upstack dashboard](https://app.upstackdata.com) under **Event Health**, confirm `PageView` events from the new landing page arrive within a few minutes.

***

<Note>
  **Need help?**

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