4 tips to migrate smoothly

The new Shopify checkout is here

The new Shopify checkout is here

Seb Harris

4 minute read05 Apr 2023

Amongst all the excitement of Shopify Winter Editions ‘23, we’ll forgive you if you missed one small but very, very important piece of information. On August 13, 2024 checkout.liquid and Shopify Scripts will be obsolete. 

What does this mean? If you currently have checkout customisations running on the Information, Shipping and/or Payment pages of your checkout, you need to upgrade to the new checkout extensibility by August 13, 2024. 

One-page checkout

The checkout extensibility is part of the new one-page checkout launched in Shopify Editions Winter ‘23. Shopify have given plenty of time for everyone to get their store in order, however we’d recommend getting this done as quickly as possible for 2 main reasons.

  1. A one-page checkout improves your ecommerce flow and is likely to ramp up conversion rates, so you want to get going with it asap.
  2. Migration shouldn’t be left to the last minute. The checkout is the single most important feature of any ecommerce store, so you don’t want to migrate in a rush.

Migration eligibility

The first thing to do is review Shopify’s official migration guide. In the Eligibility section, you’ll see the requirements for using the new upgrade. The most important to take note of are:

  1. You can only use the checkout extensibility if you’re a Shopify Plus merchant. If you haven’t made the switch to Shopify Plus yet, you don’t need to worry about this.
  2. You cannot use checkout extensibility if you’re using Global-e.

Identify checkout customisations

As the migration only concerns Shopify Plus merchants that customise their current checkout, the first migration step is to identify all customisations made to checkout.liquid. These could be:

  • Tracking pixels
  • Customised stylings
  • Content customisations
  • Shopify scripts that customise pricing, payments, delivery options etc.

How to migrate

For each area of customisation there are specific ways to migrate. Let’s take a look at a few:

1. Tracking pixels

You can either use Customer Events or a server-side tracking solution like Elevar. Shopify’s tracking pixel migration guide is a good place to begin.

2. Customise stylings

You can use Shopify’s Branding API. Note that custom fonts in the new checkout will be possible by May, so it could be a good idea to wait until then to begin if you want custom styling.

3. Content customisations

You can use Checkout Blocks or integrate with the checkout extension API via a custom app.

4. Shopify Scripts

Scripts will be decommissioned in 2024 and Shopify are introducing Shopify Functions. If you use Shopify Scripts for your checkout.liquid you should migrate to Shopify Functions in good time of the deadline.

Additional information

  1. You cannot make changes to the CSS. For stylistic changes, you must use the Branding API.
  2. You cannot inject your own Javascript into the checkout. You must use one of the supported checkout APIs for all customisations.

Do you want to
stay updated?


Stay ahead

Subscribe to our newsletter for a roundup of the latest in ecommerce, straight to your inbox.