Help for owners
My Shopify checkout customisation is going away or has broken
Short answer
Shopify has retired checkout.liquid on the information, shipping and payment steps, and publishes sunset dates for Additional scripts and script tags. The replacements are checkout extensions. Do not paste new code into checkout. Use Shopify's checkout upgrade report to list what your store uses, then send it to your developer.
Does this sound like your situation?
- A message in Shopify says my checkout customisations need upgrading.
- Tracking, a custom field or a message at checkout stopped appearing.
- My thank-you page lost scripts or conversion tracking.
- Our checkout was edited in code years ago and nobody remembers how.
- An app says it needs checkout extensions.
Why does this happen?
Shopify is retiring code-based checkout customisation
Shopify's developer page says checkout.liquid is unsupported for the information, shipping and payment checkout steps. It lists sunset dates for checkout.liquid and Additional scripts on the thank-you and order status pages, and for script tags.
Confirmed by shopify.dev
Each old customisation needs a different replacement
Shopify names UI extensions, Functions, web pixel extensions and payments extensions as the new types, and says its page does not map each old customisation to one of them. The admin has a checkout upgrade report for this.
Confirmed by shopify.dev
Tracking was often added with a script
Pixels and conversion tags were commonly pasted into Additional scripts. When those stop running, ad and analytics numbers fall without any visible error.
What can I do about it today?
- Open the checkout upgrade reportIn your Shopify admin, look for the checkout upgrade report or banner. It lists what the store uses that will be affected. Take a screenshot.
- Do not delete old code to make the warning go awayRemoving a script can stop tracking or a required message at checkout immediately.
- List what customers see at checkoutCustom fields, gift messages, delivery notes, extra buttons, banners and anything that differs from the standard checkout.
- List your tracking toolsWhich ad platforms and analytics receive purchase data, and who set them up.
- Check the dates on Shopify's pageThe sunset dates are published on Shopify's checkout page. Write down those that apply to your store and send them with the screenshot to your developer.
When should I bring someone in?
- A published sunset date is close or has passed.
- Checkout changes were written by someone who has left.
- Purchase tracking or a required field has already stopped.
How do I handle it?
- Inventory every checkout customisationI read the upgrade report together with the theme and scripts and write a table: what it does, who needs it, what replaces it.
- Drop what is no longer neededSome old customisations are covered by standard settings, and those need no code.
- Rebuild the rest as extensionsI use an app with extensions or build a custom app with them, on a development store first.
- Check tracking after the moveTest purchases confirm that conversion events and order data still arrive.
- Switch over with a rollbackI make the change at a quiet time with the old setup noted so it can be restored where Shopify still allows it.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Can I go back to checkout.liquid?
Shopify states that in some cases you can revert until the sunset dates. After that it is not available, so do not plan around it.
Will my order data be affected?
Your orders stay in Shopify. What can be affected is what runs at checkout, such as extra fields and tracking scripts.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.