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.
On this page
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 customizations
- Checkout and accounts editor
- Shopify Pixels
- Branding API
- Additional address fields in checkout
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:
- In Flight API Mutations
- Unsupported Hosted Payment SDK Gateways
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 disabled.
- 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: Since 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.
August 28, 2025 is the deadline for stores on the Shopify Plus plan 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
From your Shopify admin, go to Settings > Checkout.
-
In the Upgrade to Checkout Extensibility section, click Review customizations 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
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
Review customizations created by additional scripts
To review existing customizations created with the order status page's additional scripts, access your personalized report.
From your Shopify admin, go to Settings > Checkout.
In the Upgrade to Checkout Extensibility section, click Review customizations.
-
In the Customizations report page, you'll receive an analysis of your additional scripts, 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
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 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 with apps.
From your Shopify admin, go to Settings > Checkout.
In the Upgrade to Checkout Extensibility section, click Review customizations.
-
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 3: Create and publish new customizations
From your Shopify admin, go to Settings > Checkout.
In the Configurations section, click Create draft.
Customize your checkout, Thank you and Order status pages by adding apps or editing your branding. Learn more about customizing and editing your checkout.
Optional: Set up your Pixels or additional first party features.
Review your changes.
When you're ready to use this new checkout, click Publish.
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 Shopify 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:
- From Settings > Checkout, in the Upgrade Status section, click the revert link.
- 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
Most features introduced since 2023 aren't compatible with checkout.liquid
and are only available when you upgrade to Checkout Extensibility. Some of these features include the following examples:
- Checkout UI Extensions
- B2B
- Shop Cash
- Try-before-you-buy
- Preorders
- Shopify Functions
- Product bundles
- One-page checkout
- Local currency order editing
- Automatic payment capture per fulfillment
- Bundles in draft orders
- Capture tax ID at checkout
- Region-specific address fields in checkouts
- Split shipping at checkout
- Web pixels