Checkout extensibility upgrade guide

Note

Checkout.liquid will be deprecated for the Information, Shipping, and Payment pages on August 13, 2024.

Shopify Plus merchants can now use checkout extensibility to customize these pages instead. If you customize the Information, Shipping, or Payment pages in your checkout, then upgrade to checkout extensibility before August 13, 2024.

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 on Shopify if you're currently a store on the Shopify Plus plan using checkout.liquid. 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 new features and capabilities, including the following:

• Checkout customizations
• Checkout Editor
• Shopify Pixels
• Branding API

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:

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

Note

Checkout extensibility isn't compatible with checkout.liquid. You can use checkout extensibility to replace your checkout.liquid customizations with new or upcoming features. However, after you upgrade to checkout extensibility, advanced customizations to your Thank You or Order Status pages will continue to be completed through checkout.liquid and apps.

Upgrade to checkout extensibility

You can still upgrade to checkout extensibility even if you can't replicate all of your existing checkout.liquid customizations.

Step 1: Review your existing checkout.liquid customizations

1. From your Shopify admin, go to Online Store > Themes.
2. Find your current theme, and then click the ... button.
3. Click Edit code to review your existing checkout.liquid customizations.

Learn more about the checkout.liquid layout.

Step 2: Create and publish a new checkout

Note

Checkout theme settings aren't transferred to your draft checkout.

1. From your Shopify admin, go to Settings > Checkout.
2. In the Checkout customization section, click Create draft checkout.
3. Customize your checkout 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, click Publish to confirm that you want to replace your live checkout.liquid customizations.

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:

• Shopify discount
• Shopify functions
• Shopify metafields
• Shopify scripts

Revert to checkout.liquid

Caution

Only stores that previously had checkout.liquid active can qualify to revert back after upgrading to checkout extensibility. Eligible stores can contact Shopify Plus Support to request to revert to checkout.liquid when there isn't an option to revert to checkout.liquid on your own. Reverting isn't guaranteed.

After you upgrade to checkout extensibility, liquid customizations will only apply to your Thank You and Order Status pages. To apply liquid customizations to all of the checkout, you can revert back to checkout.liquid.

Steps:

1. From the Checkout screen, in the Checkout customization section, click checkout.liquid.
2. Click Revert to checkout.liquid.
3. Click Revert to replace your live checkout and some other checkout features.

After you revert to checkout.liquid, 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:

• Checkout UI Extensions
• Web Pixels
• B2B
• Shop Cash
• Try-before-you-buy
• Preorders
• Shopify Functions
• Product bundles