Plus - Upgrading and replacing your Thank you and Order status pages
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.
On this page
- Confirming the version of the Thank you page and Order status page on your store
- Upgrading and replacing your Thank you and Order status pages
- Reverting or downgrading pages to checkout.liquid, additional script, or apps that use script tags
- Impact of missing the August 28, 2025 deadline
- Auto-upgrades in January 2026
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:
- Review your upgrade guide.
- Review and manage your customizations using compatible installed apps.
- Review and manage incompatible installed apps.
- Review and replace your customizations that use additional scripts.
- Review and replace your customizations that use checkout.liquid.
- 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.
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 28, 2025 to expand the notice.
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:
From your Shopify admin, go to Settings > Checkout.
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 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:
- On the Upgrade guide page, go to the Incompatible apps section.
- 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.
- 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
- On the Upgrade guide page, go to the checkout-liquid section.
- 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:
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.
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:
From your Shopify admin, go to Settings > Checkout.
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.
- If these pages previously had customizations that used
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
, orcheckout_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.