Checkout extensibility upgrade guide

This page was printed on Jul 27, 2023. For the current version, visit https://help.shopify.com/en/manual/checkout-settings/checkout-extensibility/checkout-upgrade.

You can useShopify checkoutto accept orders and receive payments wherever you sell online. If your store is on theShopify Plusplan, then you can use checkout extensibility to add apps and customize your branding 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 on Shopify if you're currently a store on the Shopify Plus plan usingcheckout.liquid. Use theCheckout Extensibility Upgrade Kitto learn more about how to assess and replace your current checkout customizations.

On this page

About checkout extensibility

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

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, you need to be a store on the Shopify Plus plan. Currently, checkout extensibility can't be used if you use Global-e, but is planned to be available in Q3. You also can't use any features that are incompatible with checkout extensibility, such as the following features:

  • Advanced Cash on Delivery
  • In Flight API Mutations
  • Unsupported Hosted Payment SDK Gateways

Upgrade to checkout extensibility

You can still upgrade to checkout extensibility even if you can't replicate all of your existingcheckout.liquidcustomizations.

Step 1: Review your existing checkout.liquid customizations

  1. From your Shopify admin, go toOnline Store > Themes.
  2. Find your current theme, and then click the...button.
  3. ClickEdit codeto review your existingcheckout.liquidcustomizations.

Learn more about thecheckout.liquidlayout.

Step 2: Create and publish a new checkout

  1. From your Shopify admin, go toSettings>Checkout.
  2. In theCheckout customization部分,按kCreate draft checkout.
  3. 定制您的结帐通过添加应用程序或编辑your branding. Learn more aboutcustomizing and editing your checkout.
  4. Optional: Set up yourPixelsoradditional first party features.
  5. Review your changes.
  6. When you're ready to use this new checkout, clickPublish.
  7. In the pop-up window that appears, clickPublishto confirm that you want to replace your livecheckout.liquidcustomizations.

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

Optional: Installing checkout apps

考虑安装checkout apps from the Shopify App Storeto 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 usingcheckout.liquidto track customer events, then you should replace it withPixelsbefore publishing your draft checkout.

Optional: Setting up additional first-party features

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

Examples of features that are now supported in Shopify include the following:

Revert to checkout.liquid

After you upgrade to checkout extensibility, liquid customizations will only apply to yourThank YouandOrder Statuspages. To apply liquid customizations to all of the checkout, you can revert back tocheckout.liquid.

Steps:

  1. From the Checkout screen, in theCheckout customization部分,按kcheckout.liquid.
  2. ClickRevert to checkout.liquid.
  3. ClickRevertto replace your live checkout and some other checkout features.

After you revert tocheckout.liquid, your checkout extensibility customizations are saved as a draft that you can update and publish later.

If you started usingfeatures incompatible withcheckout.liquidand you revert tocheckout.liquid, then these features will stop working.

Features incompatible with checkout.liquid

The following features are incompatible withcheckout.liquidand are only available when you upgrade to checkout extensibility:

Ready to start selling with Shopify?

Try it free