Reviewing and replacing additional scripts on your Thank you and Order status pages

Additional scripts for tracking and analytics and page customizations aren't supported on the new Thank you and Order status pages. As part of upgrading your Thank you and Order status pages, you need to review and replace any existing additional scripts that you use on these pages.

The steps in this article apply to Shopify stores on all plans, and are only part of the process to upgrade and replace your Thank you and Order status pages. Learn more about upgrading and replacing your Thank you and Order status pages for stores on the Shopify Plus plan, or stores on non-Shopify Plus plans.

Review and replace your additional scripts for tracking and analytics

If you have additional scripts in your existing Thank you page for tracking and analytics purposes, then you need to replace those customizations using pixels.

All of the recommended tracking and analytics apps in the Additional scripts section of your upgrade guide are apps that use web pixels, and are compatible with the new Thank you and Order status pages. App pixels are the recommended solution in the upgrade guide for improved stability, security, and performance. However, if there isn't an app that meets your needs, then you can create a custom pixel.

Note

If you're using a custom domain in your online store, then you must also change your customer account domain to a subdomain of your online store domain, such as account.example.com. Otherwise, pixels and cookie consent won't work for the Order status page because the domain must be the same as where consent is obtained. Learn more about custom domains on customer account pages.

Note

After you replace your additional scripts with pixels, you might notice a decrease in events received by the third-party platform. This is because app pixels and custom pixels only track customer behavior with consent, whereas consent is often not set up properly in additional scripts or checkout.liquid code. Learn more about customer privacy settings.

Step 1: Review your additional scripts for tracking and analytics and decide which customizations to replace

1. On the Upgrade guide page in your Shopify admin, go to the Additional scripts section.
2. In the Tracking and analytics section, review the additional scripts that you use, and then do either of the following:
   • For customizations that you don't want to replace, click the dotted circle icon next to the script to mark it as reviewed.
   • For customizations that you want to replace, replace the script it with an app pixel:
     • If there's a direct match with a compatible web pixel app, then an app recommendation displays below the script. Depending whether the app match is already installed on your store, click Install or Connect.
     • If there's no direct app match provided, then follow the steps in the upgrade guide to find a compatible web pixel app to replace your script.
3. After you select a compatible app, follow the steps to install, connect, and test app pixels.

Step 2: Install, connect, and test app pixels

Note

To ensure no interruptions in event tracking, you should connect an app pixel before deactivating an additional script. However, this results in a short period of duplicate events where both the app pixel and additional script are on your Thank you page. To prevent any duplicate events, you can first deactivate the additional script before connecting the app pixel.

After you choose the app that you want to replace an additional script with, you need to install the app and then test the app pixel. Setting up an app pixel usually requires you to set up or connect your third-party account to connect the pixel. For example, if you use the Google & YouTube app, then you need to connect your Google account. Learn more about app pixels.

If the third-party app that you install has its own pixel helper tool, then you can use it to test whether your pixel events are received by the third-party platform.

Steps:

1. Install the app that you want to use, and then follow the app developer's instructions to set up the app.
2. Test the app pixel to make sure that the events are loading on your store and being received by the third-party platform.
3. After you confirm that the app pixel is sending events and the third-party platform is receiving them, deactivate the existing additional script.

Repeat these steps for each additional script in the Tracking and analytics section of your upgrade guide. After you connect and test an app pixel to replace a customization, you need to deactivate the existing additional script to prevent duplicate events.

Step 3: Deactivate additional scripts to prevent duplicate events

When you install, connect, and test pixels to replace your additional scripts, duplicate events are tracked on the existing Thank you page, because the third-party platform counts event both from the script and from the app pixel.

To prevent further duplicate events and ensure the accuracy of your conversion tracking data, you need to deactivate the additional script after you've connected and tested the pixel.

Note

The Order status page additional scripts section in your Shopify admin isn't expandable. If you have a lot of code in this section, then consider copying and pasting the code into an external text editor tool to find the specific script that you want to deactivate.

Steps:

1. From your Shopify admin, go to Settings > Checkout.

2. In the Order status page additional scripts section, find the additional script that you want to remove, and then type <!-- at the beginning of the script, and --> at the end of the script.

3. Click Save.

4. Check the third-party platform again to make sure that events are still being received.

Note

If events aren't loading on your store or received by the third-party platform after installing and testing the app pixel, then refer to Troubleshooting an app pixel.

Review and replace additional scripts for page customizations

Additional script customizations aren't supported on the new Thank you and Order status pages. If you have additional scripts that customize your Thank you or Order status pages, then you need to replace them.

All of the recommended apps in the Page customizations section of your upgrade guide are apps that offer blocks for the new Thank you or Order status page.

Steps:

1. On the Upgrade guide page in your Shopify admin, go to the Additional scripts section.
2. In the Page customizations section, review each customization, and then do either of the following:
   • For customizations that you don't want to replace, click the dotted circle icon next to the script to mark it as reviewed.
   • For customizations that you want to replace, do either of the following:
     • If there's a direct match with a compatible app, then an app recommendation displays below the script. Depending whether the app is already installed on your store, click Install or Connect.
     • If there's no direct match provided, then follow the steps in the upgrade guide to find a built-in Shopify feature or compatible app to replace your script.
3. After you install a compatible app, follow the steps to add blocks from installed apps to your Thank you or Order status page.

Repeat these steps for each page customization that you want to replace.