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.


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:

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.

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


  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:

Ready to start selling with Shopify?Try it free