Treat Shopify’s tracking migration as an audit: inventory legacy scripts, assign one owner per event, verify app or web pixels with a test order, and record what changed before trusting campaign reports.
Shopify’s checkout and pixel architecture has changed enough that a connected app is not proof that measurement still works. A fashion brand can have a working product-page event but a missing purchase event; a beauty brand can have both an app pixel and an old snippet counting the same customer action.
This workflow is for the person responsible for Shopify reporting, paid-media decisions, merchandising launches, or agency handoffs. It is an operating audit, not a code migration tutorial.
Shopify says stores that had not upgraded their Thank you and Order status pages by August 26, 2026 were upgraded automatically.[3] The platform’s upgrade guidance tells merchants to review incompatible apps, replace Additional Scripts customizations, and use app pixels or web pixels for customer-event tracking.[4]
That deadline does not mean every storefront script disappeared at once. Shopify’s developer guidance says storefront script tags could no longer be created or updated from October 1, 2026, while existing tags continue to run until March 1, 2027.[5] Order-status script tags follow a separate schedule: they stopped running for non-Plus stores on August 26, 2026, with web pixels as the tracking replacement.[6]
The practical question is not “Which deadline applies to us?” It is “Which customer events, page customizations, and app behaviors does our store still own, and where do they run?”
Start with the customer journey and then map the implementation behind it:
| Surface | What to inventory | What to prove |
|---|---|---|
| Storefront | Theme code, app embeds, script tags, tag managers, and marketing pixels | The expected browse, product, and cart events have one clear owner |
| Checkout | Plus-only checkout.liquid where applicable, checkout apps, and pixel configuration | Checkout events are available through a supported integration |
| Thank you page | Additional Scripts history, app pixels, and post-purchase customizations | The order-completion event arrives once with the intended data |
| Order status page | Script-tag dependencies, customer-account extensions, and web pixels | Returning customers do not depend on a sunset integration |
| Reporting | Shopify orders, ad platforms, analytics tools, consent settings, and agency dashboards | The team knows which system answers which business question |
Shopify’s pixel migration guidance lists theme.liquid, checkout.liquid on Plus, Additional Scripts, and Preferences as places where older pixels may exist.[1] Add app settings, tag-manager containers, custom pixels, and vendor dashboards to the inventory because an app can own tracking without leaving an obvious snippet in the theme.
Do not delete code during this pass. Save a copy of each legacy snippet, note its location, identify its owner, and record the event names it appears to send. A simple worksheet can use these columns:
This inventory is valuable even when the answer is “retire it.” It prevents a team from rebuilding a script that no longer serves a live business requirement.
Do not migrate every old script into a custom pixel. Classify the behavior before choosing a replacement.
For analytics, conversion, or customer-behavior tracking, evaluate the app pixel or web-pixel path first. Shopify’s platform guidance maps tracking behavior to web pixels and describes app pixels as a managed way for apps to collect customer events.[2][6]
An existing custom pixel can still be appropriate when the store has a documented event requirement that an app does not cover. Shopify’s migration guidance says custom pixels should subscribe to the required standard or custom customer events, while old code should be removed or replaced according to the event it was sending.[1]
A tracking pixel cannot recreate a banner, survey form, loyalty block, or other visible interface. Treat those as a separate customization problem and review the compatible app, block, or extension path in the checkout upgrade guide.[4]
If an app still uses a storefront script tag, check whether it provides an app embed block. Shopify says app embed blocks are the replacement for storefront JavaScript loaded through script tags, and warns that an embed must be active on the published theme before the old tag is deleted.[5]
Mark code with no current owner, event requirement, or business purpose as a retirement candidate. “It has always been there” is not a measurement strategy, and removing an unused dependency can be safer than giving it a new home without a testable purpose.
Migration sequencing creates a real trade-off. Shopify notes that connecting a new custom pixel before removing the old one can reduce the chance of missing events, while removing the old pixel first can reduce duplicate tracking.[1]
Choose the rule that matches the risk you are trying to control:
Do not promise that an automatic platform change can be rolled back. Shopify’s upgrade guidance described limited revert conditions for earlier manual upgrades, while stores that missed the August 26 deadline were automatically upgraded.[3][4] Treat the saved inventory, configuration record, and tested replacement as the safety net.
A green “connected” label answers whether a configuration exists. It does not prove that the merchant’s required event arrives with the expected data.
Use a clean test path that represents how customers actually buy:
Shopify says standard customer events such as page views, product views, cart updates, purchases, and searches are available through the pixel system, but the exact implementation and data available depend on the pixel.[2] The test record should therefore state what was observed rather than claim that every pixel exposes every field.
The primary success measure is a duplicate-free, end-to-end path for each critical event. Secondary checks include whether the event is available under the expected consent state, whether the value and currency are usable for the destination platform, and whether the event owner is still documented after the test.
For a fashion store, the critical path may be product view → add to cart → purchase for a new collection campaign. For a beauty store, add subscription or shade-selection events only when the implementation and business decision actually require them. A broader Shopify merchant may prioritize purchase, refund, fulfillment, or post-purchase survey events instead. The audit should follow the commercial decision, not a universal event checklist.
Pixels are not unrestricted scripts. Shopify says app and custom pixels run in a sandbox with limitations that can affect DOM scraping, form-field detection, outbound-link detection, scrolling, and heatmap behavior.[2]
That changes the migration question from “Can this old snippet be pasted into the new field?” to “Does the replacement receive the event data it needs through a supported path?” If the old implementation depended on reading a button, form, URL, or DOM element directly, document the missing input and decide whether the storefront should publish an explicit custom event, use an app pixel, or drop the measurement requirement.[1][2]
Consent is part of the event definition. Shopify says web pixels in markets configured to require consent run only after visitors provide the permissions required by the pixel configuration.[2] A lower event count after migration is not automatically a broken tag, and a higher count is not automatically an improvement. Record the market, consent state, browser context, and implementation version alongside the test result.
Shopify also warns that custom pixels can create performance and privacy risks when they use unsafe code or bypass consent requirements.[2] Keep a named owner for pixel changes, remove unused code, and have the person responsible for privacy review the data-sharing behavior before launch. This article provides operational guidance, not legal advice.
Use the evidence from the audit to make a bounded decision:
| Decision | Use it when | Next action |
|---|---|---|
| Go | Each critical event has one owner, the replacement is active, consent behavior is understood, and the test path is duplicate-free | Record the implementation version and monitor the next reporting cycle |
| Hold | A purchase event is missing, an event is duplicated, an app is incompatible, or no one owns a legacy script | Keep the change scoped, contact the vendor or agency, and retest before relying on the data |
| Narrow the change | The main migration works but one custom event, UI feature, or low-priority report is unresolved | Launch the verified path and create a separate decision for the unresolved behavior |
| Retire | The script has no current owner or business question and no test shows it is needed | Save the inventory record, remove it through the supported path, and verify that the storefront still works |
Do not judge the migration by a single dashboard total. Compare like with like: the same event, time window, consent assumptions, attribution definition, and receiving system. Shopify notes that analytics services can process and filter data differently, so cross-service totals should be treated as a reconciliation task rather than a simple pass/fail number.[1]
If campaign decisions depend on Meta tracking, the Meta Pixel guide for Shopify can provide a provider-specific follow-up after this platform-wide inventory. Keep that implementation check subordinate to the larger ownership map: a perfectly configured Meta pixel can still coexist with a duplicate Google tag, an abandoned script tag, or a missing post-purchase event.
Finish with a short change record that another operator can understand without repeating the investigation:
A useful migration ends with a smaller, more explainable measurement system. If the team cannot say where a purchase event comes from, which consent state permits it, and what happens when the theme or checkout changes again, the audit is not finished.
[1] https://help.shopify.com/en/manual/promoting-marketing/pixels/pixel-migration [2] https://help.shopify.com/en/manual/promoting-marketing/pixels/overview [3] https://help.shopify.com/en/manual/checkout-settings/customize-checkout-configurations/upgrade-thank-you-order-status [4] https://help.shopify.com/en/manual/checkout-settings/customize-checkout-configurations/upgrade-thank-you-order-status/upgrade-guide [5] https://shopify.dev/docs/apps/build/online-store/script-tag-deprecation/storefront [6] https://shopify.dev/docs/apps/build/online-store/script-tag-deprecation/order-status