Plus - Customize and replace your Thank you and Order status pages

Plan requirement

The instructions in this guide apply only to merchants with stores on the Shopify Plus plan.

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 13, 2024: Deadline to upgrade your Information, Shipping, and Payment pages.
• 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.

Shops that haven't yet completed the upgrade of their Information, Shipping, and Payment pages can refer to the Impact of missing the August 13, 2024 deadline.

Use the checkout and accounts editor to customize the design and functionality of your Thank you and Order status pages and Pixels to manage customer events. You can customize these pages using app blocks and web pixels.

August 28, 2025 is the deadline to replace your Thank you and Order status pages by recreating your customizations that use checkout.liquid, additional scripts, and apps that use script tags. Replacing these pages allows you to add customizations in a way that's app-based and upgrade-safe.

About the Thank you and Order status pages

The Thank you and Order status pages are pages that display in the Shopify Checkout when a customer has completed a purchase.

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. The Order status page can be bookmarked and revisited by the customer multiple times to access shipping updates and order details.

Learn more about the order status page.

Customizing and replacing your Thank you and Order status pages

August 28, 2025 is the deadline for stores on the Shopify Plus plan to recreate current customizations, and then replace your Thank you and Order status pages. Shopify Scripts will also be shut off on this date, but will continue to work alongside app blocks and web pixels until then. Scripts should be replaced with Shopify Functions before this date.

Step 1: Review your Thank you and Order status page customizations

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 replace your Thank you and Order status pages is displayed, then it means you’re still using the deprecated version.

A personalized report identifying the existing customizations for your Thank you and Order status pages has been automatically generated for you. The report is available in the Shopify admin and as a downloadable CSV file. Use this report to help you decide which customizations to recreate.

Review customizations created by checkout.liquid and additional scripts

To review existing customizations created with the order status page's additional scripts, access your personalized report.

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

2. In the Configurations section, click Review customizations.

3. In the Customizations report page, you'll receive an analysis of your checkout.liquid and additional scripts customizations, including the following data:

   • Category of customization, such as Conversion Pixels or Order tracking
   • Customization name and description
   • Source file, such as additional scripts
   • Guidance for recreating the customization in the checkout and accounts editor

Review customizations created by apps that use script tags

To continue using Thank you and Order status page customizations created with apps, an app must be updated by the app developer so you can recreate customizations using app blocks and web pixels. For apps that have been updated by the app developer, you can follow their setup instructions to get started. You can contact the app developer about apps that still require an update and aren't yet ready for you to set up.

Learn more about customizing your checkout and accounts with apps.

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

2. In the Configurations section, click Review customizations.

3. In the Customizations report page, you'll receive a list of apps divided into the following types:

   • Apps that have been updated by the app developer and are ready for you to set up and recreate your customizations.
   • Apps that require an update by the app developer before you can set them up and recreate your customizations. You can contact the app developer directly for more information.

Step 2: Recreate and replace customizations

Note

You can’t replace your Thank you and Order status pages separately, so make sure you’re finished customizing both pages before clicking Replace pages.

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

2. In the Configurations section, click Customize.

3. Customize your Thank you and Order status pages with app blocks and web pixels. Learn more about customizing and editing your checkout and accounts.

4. Optional: Set up your web pixels or additional first party features.

5. Review your changes.

6. When you're ready to publish and replace both of your Thank you and Order status page customizations, click Replace pages. This action replaces the existing link to the Order status page from order notifications. You can revert if needed.

Optional: Installing checkout and accounts apps

Consider installing apps from the Shopify App Store to enhance your checkout and accounts through added functionalities that can help you grow conversions, increase average order value, and more. Checkout Blocks is a free app that offers a wide range of simple customizations, but there are many more available in the Shopify App Store.

Optional: Setting up your web pixels

If you're currently using checkout.liquid to track customer events, then you should replace it with web pixels.

Optional: Setting up additional first-party features

It's possible that many of your checkout.liquid customizations are now supported in Shopify.

Features that are now supported in Shopify include the following examples:

• Discounts
• Shopify Functions
• Metafields

Revert or downgrade pages to checkout.liquid, additional script, or apps that use script tags

Caution

After upgrading your checkout pages, stores have until their auto-upgrade date to revert. After this date, the ability to revert is removed. Restrictions will apply if the checkout pages are reverted.

All stores on the Shopify Plus plan can revert or downgrade their Thank you and Order status pages until August 28, 2025 in order to use checkout.liquid, additional scripts, or apps that use script tags. Many features will stop working when you revert or downgrade.

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.

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.

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, we 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:

• Checkout.liquid customizations 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

Starting January 6, 2025, we will begin auto-upgrading checkouts that continue 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.