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

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

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 13, 2024 deadline

August 13, 2024 was the deadline to upgrade from checkout.liquid to Checkout Extensibility for the Information, Shipping, and Payment pages. Checkout.liquid is deprecated and has not been updated with new functionality since 2021. With ever-changing regulations worldwide, including the introduction of card industry rules under PCI DSS v4, checkout.liquid is less secure than Checkout Extensibility, and we must discontinue its support.

Starting August 14, 2024, Shopify began the process of shutting down checkout.liquid for the Information, Shipping, and Payment pages completely, and shops that aren't upgraded will see the following impacts:

• Customizations to checkout.liquid are locked: Shopify won't provide customer support for updating or fixing checkout.liquid customizations on the Information, Shipping, and Payment pages. Customizations will be locked and uneditable. Shops using this obsolete code past the deadline do so at their own risk.
• Payment gateways are locked: The ability to deactivate payment gateways or switch providers is deactivated.
• Risk indicators for orders are disabled: Accurate risk assessment becomes unreliable with unsandboxed code executing in checkout, so fraud indicators and recommendations in the admin aren't available for new orders.
• Slower Shopify Payments payouts: Because orders will be deemed as higher risk, payouts may be delayed by up to 5 days after a transaction is processed.

Auto-upgrades starting January 6, 2025

As of January 6, 2025, Shopify has started auto-upgrading checkouts that continue to use to use checkout.liquid with 30-day notice by email, which means:

• The Information, Shipping, and Payment pages will revert to a default state, losing all checkout.liquid customizations.
• The storefront will continue to process checkouts absent these customizations.
• Brand settings defined in the online store theme editor will be automatically applied to the default checkout, but any visual customizations made through .liquid or associated custom JavaScript and CSS files won't be loaded.