Non-Plus - Upgrading and replacing your Thank you and Order status pages
Shopify is moving to a new foundation for checkout and accounts that's more secure, upgrade-safe, and lets you customize with app blocks and pixels. If you currently use additional scripts or apps to customize your Thank you or Order status pages, 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.
On this page
About the Thank you and Order status pages
Customers access the Thank you and Order status pages after checkout.
Thank you page
The Thank you page is displayed to customers after they complete checkout, and is a one-time page that the customer can't access again. It provides confirmation of the order and confirms that the checkout was successful. It displays a confirmation number instead of an order number.
Order status page
After an order is created in Shopify, the customer receives an order confirmation notification. The order confirmation links to the Order status page. Several order notifications, such as shipping notifications, link to the Order status page by default. A customer can revisit their Order status page multiple times to track and manage their order.
Learn more about the Order status page.
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 continue using a customization that was created with an app, the app must be updated by the app developer so that you can recreate the customization using app blocks or pixels to be compatible with the new Thank you and Order status pages.
To customize and replace your Thank you and Order status pages, you need to complete the following steps:
- Review your upgrade guide.
- Review and manage your customizations using compatible installed apps.
- Review and manage incompatible installed apps.
- Replace your customizations that use additional scripts.
- 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. Access this guide from your Shopify admin to identify your existing customizations, and learn how to recreate them.
Steps:
From your Shopify admin, go to Settings > Checkout.
In the Configurations section, on the configuration that you want to update, click Upgrade Thank you and Order status pages by August 26, 2026 to expand the notice.
Click Review customizations.
Step 2: Review and upgrade your customizations using compatible installed apps
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:
- On the Upgrade guide page, go to the Apps section.
- 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.
- 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 upgrade 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:
- On the Upgrade guide page, go to Incompatible apps.
- In the Custom apps section, check that your custom app pixels are set up to ensure that tracking will work on the new Thank you and Order Status pages.
- 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 upgrade your existing additional scripts customizations
Your additional scripts customizations are grouped into categories, such as the following examples:
- Customer events
- Informational
- Marketing
- Order management
- Styling
- Tag manager
Your upgrade guide provides solutions that you can choose from to replace each of these customization types.
Steps:
- On the Upgrade guide page, go to the Additional scripts section.
- Review the additional scripts that you use, and then follow the guidance to replace your customizations.
Step 5: 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:
From your Shopify admin, go to Settings > Checkout.
In the Configurations section, on the configuration that you want to update, click Open upgrade report.
From the Upgrade guide page, click Upgrade.
If you need to revert to the previous version of your Thank you and Order status pages, then you can revert before August 26, 2026.
Revert your Thank you and Order status pages to use additional scripts and apps with deprecated features
You can revert 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 additional scripts or apps that use script tags
- You manually upgraded your Thank you and Order status pages less than 30 days ago
After you revert, your customizations made with app blocks are saved as a draft configuration that you can update and publish again later.
If you don't upgrade your pages again before August 26, 2026, then your Thank you and Order status pages will be auto-upgraded to the new pages.
Steps:
From your Shopify admin, go to Settings > Checkout.
In the Order status page additional scripts section, click the revert link.
Select a revert reason, and then click Revert.
After you revert, your customizations made with app blocks and web pixels are saved as a draft configuration that you can update and publish again later.