Shopify Checkout Extensibility

❗️

Upgrading your Thank You page and Order Status pages WILL impact tracking in Northbeam

Our Purchase Event script is placed on the Order Status page to track conversions on Shopify’s native checkout. You'll need to add a new script to the Customer Events.

If you've upgraded your Thank You and Order Status pages, reference the directions below.

(Note: If you've only upgraded your Information, Shipping, and Payment pages -- no action is needed)

📘

Not sure if your Thank You and Order Status pages are upgraded?

If Additional Scripts in the Order Status Page section is missing or greyed out, this means your Thank You and Order Status pages are upgraded.

  1. Log into your Shopify account
  2. Click Settings
  3. Click Checkout
  4. Find the section called Order Status Page and reference the Additional Scripts field
  5. If this field is missing or greyed out, your Thank You and Order Status pages are upgraded.

Checkout Extensibility Overview

As of February 2023, Shopify began phasing out checkout.liquid in favor of a more modern and secure framework called Checkout Extensibility. This new approach is app-based, upgrade-safe, and designed to improve performance and flexibility across the checkout experience.

Key Upgrade Deadlines:

Shopify Plus Stores (Official Shopify Documentation)

  • August 28, 2025- Deadline to upgrade your Thank You and Order Status pages. This includes migrating any customizations made with script tags or additional scripts to the new Checkout Extensibility framework.

Non-Plus Shopify Stores (Official Shopify Documentation)

  • August 26, 2026 - Deadline to upgrade Thank You and Order Status pages to their extensible versions for stores on standard (non-Plus) Shopify plans.

🚧

Have you ONLY upgraded your Information, Shipping, and Payment Pages?

No action needed! Your Order Status Page field should still be available. If so, keep using our legacy Order Status Page script.


If your Thank You and Order Status pages are upgraded...

Step 1: Find a new script in your Northbeam Dashboard

  1. Click on Settings
  2. Click on Northbeam Pixel and Event Tracking
  3. Find the script called Shopify: Customer Events

Step 2: Insert the script in your Customer Events

  1. Log into your Shopify account, click Settings
  2. In the side navigation, click Customer Events
  3. In the top right, click Add Custom Pixel
  4. Name the pixel anything you'd like (e.g. "Northbeam”), then click Add Pixel
  5. In your Northbeam dashboard, go to Settings > Northbeam Pixel and Event Tracking
  6. Copy the script under Shopify: Customer Events
  7. Paste the script into the code editor
  8. In the top right corner, click Save
  9. Below the editor, click Connect
  10. In the modal, click Connect to give the pixel secure access to your online store, checkout, and order confirmation.

Step 3: Remove the Pixel from Google Tag Manager (if applicable)

If you’re using Google Tag Manager (GTM) to run your Northbeam Pixel, follow these steps. If not, move to Step 4.

  1. Disable the tag associated to the Northbeam Pixel in GTM
  2. Add the same pixel script directly into your Shopify theme.liquid file
  3. This helps prevent the pixel from firing twice — once from GTM and once from our Checkout Script
  4. We’ll remotely disable page view tracking from theme.liquid to avoid duplication, while still allowing for custom event tracking
  5. Note: If certain pages aren’t controlled by theme.liquid, keep the GTM tag active only for those pages and update the trigger settings accordingly.
    1. For example, if a subdomain (ex. blog.northbeam.io) is not part of the main theme, enable the GTM tag and adjust the trigger so it only fires on blog.northbeam.io.
    2. The goal is to make sure the Northbeam Pixel fires once per page, no more.

Step 4 Reach out our team and confirm the following:

  1. Your Thank You Page and Order Status Pages HAVE been upgraded
  2. The Customer Event HAS been placed
  3. Our team will make an adjustment to your backend to ensure proper tracking.

❗️

When the script is added, reach out to our team.

We’ll need to make a slight adjustment to your backend for proper tracking.