Plus - Upgrading and replacing your Thank you and Order status pages

Plan requirement

August 28, 2025 is the deadline to replace your existing Thank you and Order status pages with the new version of those pages.

The instructions in this guide apply only to merchants with stores on the Shopify Plus plan. Stores not on the Shopify Plus plan need to follow the Non-Plus upgrade guide instead.

Note

In February 2023 we announced that checkout.liquid is deprecated, and that we’re moving to a new foundation for checkout and accounts that is more secure, upgrade-safe, and customized using apps.

Required Upgrade Timeline

• August 28, 2025: Deadline to upgrade your Thank you and Order status pages, including your apps using script tags and additional scripts.
• January 2026: Automatic upgrades begin, and all customizations using additional scripts, apps with script tags, or checkout.liquid on the Thank you and Order status pages will be lost.

Shopify has introduced a new foundation for checkout and accounts that's more secure, upgrade-safe, and lets you more easily customize your checkout and customer accounts pages. This includes a new version of the Thank you and Order status pages, which are customizable in the checkout and accounts editor.

If you've previously customized your Thank you and Order status pages with incompatible apps, scripts, or pixels, then you're required to upgrade and replace your existing customizations so that you and your customers can continue to benefit from Shopify's secure checkout platform.

If you've customized your existing Thank you and Order status pages using checkout.liquid, additional scripts, or apps that use script tags, then you need to upgrade your customizations in the following ways:

• Use app blocks and web pixels to recreate customizations to the design and functionality of your Thank you and Order status pages.
• Use app pixels to continue tracking customer events.

When you upgrade, your existing Thank you and Order status pages and any existing customizations on those pages are replaced with the new versions of those pages.

Confirming the version of the Thank you page and Order status page on your store

To confirm if you’re still using the deprecated versions of the Thank you and Order status pages, go to Settings > Checkout and review the Configurations section. If a notice to upgrade your Thank you and Order status pages displays, then it means you’re still using the deprecated versions, and need to follow the guidance to customize the new pages and upgrade them.

Upgrading and replacing your Thank you and Order status pages

To upgrade and replace your Thank you and Order status pages, you need to complete the following steps:

1. Review your upgrade guide.
2. Review and manage your customizations using compatible installed apps.
3. Review and manage incompatible installed apps.
4. Review and replace your customizations that use additional scripts.
5. Review and replace your customizations that use checkout.liquid.
6. Replace your Thank you and Order status pages to publish your customizations.

Step 1: Review your upgrade guide

A personalized upgrade guide that identifies the existing customizations for your Thank you and Order status pages has been automatically generated for you in your Shopify admin. Use this report to help you decide which customizations to recreate.

Note

If your upgrade guide is empty, then you can proceed to Step 6: Replace your Thank you and Order status pages to publish your customizations.

Steps:

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

2. In the Configurations section, on the configuration that you want to update, click Upgrade Thank you and Order status pages by August 28, 2025 to expand the notice.

3. Click Review customizations.

Step 2: Review and upgrade your customizations using compatible installed apps

To review your existing customizations, you can access your personalized upgrade guide in your Shopify admin.

The Apps section on the Upgrade guide page displays installed apps that have been updated by the developer to be compatible with the new Thank you and Order status pages.

Follow the guidance for each app in the Apps section to ensure that your existing tracking and page customizations will work on the new Order status and Thank you pages.

Steps:

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

2. On the Upgrade guide page, go to the Apps section.

3. In the Tracking and analytics section click Manage next to an app to set up app pixel tracking to work on the new Thank you and Order status page.

4. In the Page customizations section, click Add app blocks to recreate your page customizations using app blocks. Learn more about customizing your checkout and accounts with apps.

Step 3: Review and manage incompatible installed apps

The Incompatible apps section on the Upgrade guide page indicates which installed apps on your store haven't been updated by the developer to be compatible with the new Thank you and Order status pages.

If an app hasn't been updated to offer compatible customization features using app blocks or web pixels, then contact the app developer or install an alternate app.

Steps:

1. On the Upgrade guide page, go to the Incompatible apps section.
2. In the Custom apps section, update your custom apps to use UI extensions or web pixels instead of script tags to ensure that tracking will work on the new Thank you and Order status pages.
3. Review the apps in the Apps that require update from a developer section, and then contact the app developer for support to continue using the app with the new Thank you and Order status pages. Alternatively, you can install a different app.

Step 4: Review and replace your existing additional scripts customizations

If you have additional scripts on your existing Thank you and Order status pages, then you need to replace those customizations on the new versions of those pages. This includes additional scripts that you've used for tracking and analytics or page customizations.

Your upgrade guide categorizes your additional scripts based on their purpose, such as authentication or order tracking. Depending on the category, you can replace your customizations using built-in Shopify features, apps from the Shopify App Store, or custom apps.

For the complete steps to replace your additional scripts customizations, refer to Reviewing and replacing additional scripts on your Thank you and Order status pages.

Step 5: Review and replace customizations created using checkout.liquid

1. On the Upgrade guide page, go to the checkout-liquid section.
2. Review the existing checkout.liquid customizations on your store, and then follow the guidance to replace your customizations.

Step 6: Replace your Thank you and Order status pages to publish your customizations

After you've customized the new Thank you and Order status pages, you need to upgrade to replace your existing pages. After you upgrade, the new Thank You and Order status pages will display to customers after checkout.

Steps:

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

2. In the Configurations section, on the configuration that you want to update, click Open upgrade report.

3. From the Upgrade guide page, click Upgrade.

Reverting or downgrading pages to checkout.liquid, additional script, or apps that use script tags

You can revert or downgrade to the old versions of your Thank you and Order status pages if your store meets all of the following conditions:

• Your store was created before January 6, 2025.
• Your store has pre-existing customizations to your Thank you and Order status pages using checkout.liquid, additional script, or apps that use script tags.
• You manually upgraded your Thank you and Order status pages less than 30 days ago.

Restrictions will apply if the checkout pages are reverted. After you revert or downgrade, your customizations made with app blocks and web pixels are saved as a draft configuration that you can update and publish again later.

If you don't upgrade your pages again before August 28, 2025, then your Thank you and Order status pages will be auto-upgraded to the new pages.

Steps:

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

2. In the Order status page additional scripts section, do either of the following actions:

   • If these pages previously had customizations that used checkout.liquid, additional scripts, or apps that use script tags, then click the revert link.

     

   • If these pages didn't previously have customizations that used checkout.liquid, additional scripts, or apps that use script tags, then click the downgrade pages link. Downgrading the pages won't affect your Shopify Plus plan; it just allows deprecated customizations to be used.

     

3. Select a reason for reverting or downgrading, and then click Revert to revert or Continue to downgrade.

Impact of missing the August 28, 2025 deadline

August 28, 2025 is the deadline to upgrade to the new Thank you and Order status pages. After this date, the level of support Shopify can offer regarding legacy checkout customizations will be limited, based on what still needs to be upgraded.

Starting August 28, 2025, Shopify will begin the process of shutting down additional scripts, apps with script tags, and checkout.liquid on the Thank you and Order status pages completely, and shops that aren't upgraded will see the following impacts:

• Additional scripts and checkout.liquid won't be editable. This prevents changes that could break critical customizations that Shopify Support can't help you resolve. If you need to customize these pages, then the only way to do so is by upgrading and using blocks in the checkout and accounts editor.
• Personal Identifiable Information (PII) won't be accessible through your additional scripts, checkout.liquid, or checkout_completed pixel events. This includes email and phone number, and minimizes the sensitive data that's exposed on legacy pages. It might impact advertising performance and any automations or customizations that rely on PII.

These changes ensure the security and stability of stores that haven't yet upgraded to the new Thank you and Order status pages. Plus stores without customizations will be periodically upgraded automatically. All other Plus stores will receive a 30-day notice before being automatically upgraded in January 2026.

Auto-upgrades in January 2026

In January 2026, Shopify will auto-upgrade stores that continue to use the legacy Thank you and Order status pages with 30-day notice by email, which means:

• The Thank you and Order status pages in your current checkout configuration will replace the legacy versions. All page customizations on your legacy pages will be lost.
• All analytics scripts will be lost. However, a limited number of analytics scripts might be moved to custom pixels in a best-effort attempt to maintain continuity in your measurement.
• Personally-identifiable information (PII) will be included again in checkout_completed events in pixels.

For the optimal experience, you should review the customizations to your Thank you and Order status pages and upgrade your checkout yourself before your checkout is upgraded automatically.