Moving off checkout.liquid and Shopify Scripts

Shopify has spent the last few years retiring two old ways to customize checkout. The first was checkout.liquid, a theme file that let Plus stores edit checkout HTML directly. The second was Shopify Scripts, small Ruby programs that changed prices, shipping rates and payment methods at checkout.

Both are now gone, and every final deadline has passed. If your store was upgraded automatically, it still takes orders. Custom logic, tracking and design changes may still have dropped off without anyone noticing. This guide covers what changed, what replaces each old tool, and how we check a store after the switch.

The dates that mattered

Older articles quote earlier dates for Scripts. Shopify moved that deadline, so check the date on anything you read. The dates above come from Shopify's changelog, developer docs and Help Center.

• 13 August 2024. checkout.liquid stopped working for the Information, Shipping and Payment steps. Shopify first announced this in February 2023.
• 6 January 2025. Shopify began upgrading the remaining checkout.liquid checkouts automatically, with 30 days of email notice. Custom Liquid, JavaScript and CSS were dropped. Theme brand settings carried over.
• 28 August 2025. checkout.liquid, additional scripts and script tags were sunset on the Thank you and Order status pages for Plus stores.
• 15 April 2026. Merchants could no longer edit or publish Shopify Scripts.
• 30 June 2026. All Shopify Scripts stopped running.
• 26 August 2026. Non-Plus stores had to upgrade their Thank you and Order status pages. Shopify upgraded the rest automatically. Script tags on those pages were sunset for non-Plus stores on the same date.

What replaces what

Checkout extensibility is the name for the new set of tools. Each one covers part of the old setup.

• Visual changes made in checkout.liquid move to the checkout editor and branding settings. Some old customizations are now native features, so check those first.
• Custom blocks, fields and messages move to checkout UI extensions. On the Information, Shipping and Payment steps they need Shopify Plus. They run in a sandbox and cannot read the checkout HTML or payment details.
• Content on the Order status page moves to customer account UI extensions.
• Additional scripts and tracking code move to pixels. App pixels come from the apps you install. Custom pixels run in a lax sandbox and need someone who writes JavaScript.
• Line item scripts usually map to the Discount or Cart Transform function APIs.
• Shipping scripts map to Delivery Customization functions. Shipping discounts use the Discount API.
• Payment scripts, which renamed, hid or reordered payment methods, map to Payment Customization functions.
• Rules that stop an order, such as quantity limits, map to Cart and Checkout Validation functions.

Functions work on every plan when they come from a public app. A custom app that contains a Function only runs on a Plus store. This matters if you plan to build your own logic instead of installing an app.

A practical migration checklist

Run this list even if Shopify already upgraded your store. It shows what the upgrade dropped.

• In the admin, open Settings, then Checkout, and view the personalized report. Export it as CSV. It lists each customization with its source file, code lines and upgrade guidance.
• Open the Script Editor and review the Shopify Scripts customizations report. It lists every script and links to suggested apps and Function API tutorials.
• Mark each item as keep, replace with a native setting, or drop. You do not need to rebuild customizations you no longer use.
• For each item you keep, choose an app or a custom Function. Check the app listing for the Function API it uses.
• Rebuild tracking with app pixels first. Write a custom pixel only when no app covers the tool.
• Build changes in a draft checkout configuration. Review the draft, then publish it.
• Place test orders with every discount, shipping zone and payment method you offer.
• For the first two weeks, compare purchase events in each ad and analytics tool with the order count in Shopify.

Common pitfalls

• Tracking fails quietly. Purchase events stop reaching ad platforms, and nobody notices until campaigns report fewer sales. Check purchase events within a day of any change.
• Events count twice. An app pixel and a custom pixel for the same tool both fire. Keep one source per tool.
• Discounts combine in new ways. Logic that lived in one script may now sit in several Functions and discount settings. Test each discount alone and together with your other offers.
• A custom app with a Function will not run on a non-Plus store. Use a public app there.
• The Thank you page and the Order status page use different extension types. Check both pages after a test order.
• Old code stays in the theme. Snippets written for checkout.liquid or old tracking can remain in theme files. They no longer do anything and make later work harder to follow.

If you are unsure what your checkout lost in the upgrade, we can take a look. We offer a free store review, or a free call to walk through your checkout and tracking setup together.