Checkout Extensibility upgrade guide

You can use Shopify Checkout to accept orders and receive payments wherever you sell online. If your store is on the Shopify Plus plan, then you can use Checkout Extensibility to add apps and advanced branding customizations in a way that's upgrade-safe and works with Shop Pay.

This guide describes new ways that you can use Checkout Extensibility to customize your Checkout, Thank you and Order Status pages on Shopify if you're currently a store on the Shopify Plus plan. Use the Checkout Extensibility Upgrade Kit to learn more about how to assess and replace your current checkout customizations.

About Checkout Extensibility

Checkout Extensibility is a faster, better performing, more secure, and upgrade-safe option than checkout.liquid for checkout customizations. Checkout Extensibility also works seamlessly with Shop Pay. By upgrading to Checkout Extensibility, you can take advantage of several of the following new features and capabilities:

Checkout Extensibility lets you create checkout customizations that are built into apps. These apps are fast to install and upgrade-safe. To add to this, Checkout Extensibility is continuously evolving to meet your needs through new or improved features, alongside new apps.

Eligibility

To use Checkout Extensibility, your store needs to be on the Shopify Plus plan. You can't use any features that are incompatible with Checkout Extensibility, such as the following features:

Impact of missing the August 13, 2024 deadline

August 13, 2024 is 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, as we begin the process of shutting down checkout.liquid for the Information, Shipping, and Payment pages completely, shops that are not upgraded will see the following impacts:

  • Checkout.liquid customizations will be 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 method changes will be locked: The ability to add, edit, or remove payment providers from checkout will be disabled.
  • Risk indicators for orders will be disabled: Accurate risk assessment becomes unreliable with unsandboxed code executing in checkout, so fraud indicators and recommendations in the admin will no longer be available for new orders.
  • Slower Shopify Payments payouts: Since orders will be deemed as higher risk, payouts may be delayed by up to 5 days after a transaction is processed.

Starting January 6, 2025, we will begin auto-upgrading checkouts that continue to use checkout.liquid with 30-day notice via 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.

August 28, 2025 is the deadline for Plus merchants to upgrade from checkout.liquid to Checkout Extensibility for the Thank you and Order status pages. This also includes updating apps that use script tags to alternatives and replacing additional scripts with apps that use Checkout UI extensions and Shopify Pixels on those pages. Shopify Scripts will also be shut off on this date, but will continue to work alongside Checkout Extensibility until then. Scripts should be replaced with Shopify Functions before this date.

Upgrade to Checkout Extensibility

A report identifying the existing customizations to your checkout is automatically generated for you and is available in the Shopify admin and as a downloadable CSV file. Use this report to simplify your review of your existing checkout customizations and to help you upgrade to Checkout Extensibility faster.

You can still upgrade to Checkout Extensibility even if you can't replicate all of your existing customizations to checkout.liquid, additional scripts, and apps. You can choose to upgrade all pages or only Checkout pages when publishing.

Step 1: Review your existing checkout customizations

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

  2. In the Upgrade to Checkout Extensibility section, click View personalized report to open the report that contains information about existing customizations in your checkout, including the following data:

    • Category of customization, such as Branding or Validations
    • Customization name and description
    • Source file, such as checkout.liquid
    • Code lines where the customization starts and ends
    • Guidance for creating the customization in Checkout Extensibility
  3. Optional: To download a version of the report as a CSV file, click ↥ Export.

Learn more about the checkout.liquid layout.

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

  1. From your Shopify admin, go Settings > Apps to review your list of apps.
  2. Review any installed apps that customize the Thank you and Order status pages.
  3. From your Shopify admin, go to Settings > Checkout.
  4. In the Upgrade to Checkout Extensibility section, click View personalized report to open the report.
  5. Review any customizations made using Additional scripts by navigating to the Thank you and Order Status pages tab.

Step 3: Create and publish new customizations

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

  2. In the Configurations section, click Create draft.

  3. Customize your checkout, thank you and order status pages by adding apps or editing your branding. Learn more about customizing and editing your checkout.

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

  5. Review your changes.

  6. When you're ready to use this new checkout, click Publish.

  7. In the pop-up window, choose which pages to publish and then confirm you want to replace any existing customizations by clicking publish.

As Shopify makes new improvements, your new checkout will automatically update.

Optional: Installing checkout apps

Consider installing checkout apps from the Shopify App Store to enhance your checkout 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 app store.

Optional: Setting up your Pixels

If you're currently using checkout.liquid to track customer events, then you should replace it with Pixels before publishing your draft checkout.

Optional: Setting up additional first-party features

It's possible that some of your checkout.liquid customizations are now supported in Shopify. Before publishing your draft checkout, review and set up these features, as applicable.

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

Revert to checkout.liquid, additional script, or apps using script tags

Steps:

  1. From Settings > Checkout, in the Upgrade Status section, click the revert link.
  2. Select the pages that you want to revert, and then click revert.

After you revert, your Checkout Extensibility customizations are saved as a draft that you can update and publish later.

If you started using features incompatible with checkout.liquid and you revert to checkout.liquid, then these features will stop working.

Features incompatible with checkout.liquid

The following features are incompatible with checkout.liquid and are only available when you upgrade to Checkout Extensibility:

Can’t find the answers you’re looking for? We’re here to help.