Definition
Shopify Scripts were small Ruby programs that Shopify Plus stores wrote in the Script Editor app to change cart prices, shipping options and payment methods at checkout. Shopify stopped all edits on April 15, 2026 and retired Scripts on June 30, 2026, when they stopped running on every store. Shopify Functions replaced them.
How Shopify Scripts worked
Shopify Scripts were small programs, written in a stripped-down version of Ruby, that changed what happened in the cart and at checkout. A merchant or developer wrote them in the Script Editor app, which hosted them on Shopify's servers and ran them while the customer shopped.[1] Scripts were a Shopify Plus feature, and Shopify announced their end in its changelog under the Plus label.[2]
There were three script types, each acting on a different part of the order:[1]
- Line item scripts worked on the products in the cart. They could change prices and grant discounts, which made them the usual home for tiered pricing, "buy X get Y" offers and VIP discounts.
- Shipping scripts could rename, show, hide, reorder or discount shipping methods.
- Payment scripts could rename, show, hide or reorder payment gateways.
The appeal was speed. One Ruby file, edited in the admin and published in minutes, with no app to build or host. The weakness was the same thing seen from the other side: all of a store's custom checkout logic sat in a few scripts that only a Ruby developer could read, outside the app and extension model that Shopify moved the rest of checkout to.
The deprecation timeline
Shopify retired Scripts in stages. The dates below are the ones Shopify published:
| Date | What happened |
|---|---|
| September 3, 2024 | Shopify archived its public Scripts examples repository. Its notice gave August 28, 2025 as the removal date, a date that was later replaced.[1] |
| March 12, 2026 | Shopify's merchant changelog set the final schedule and told Plus merchants to migrate to Shopify Functions or a public app.[2] |
| April 15, 2026 | Editing and publishing new Shopify Scripts was no longer possible.[3][2] |
| June 30, 2026 | All Shopify Scripts stopped executing.[3] |
Before the cut-off, Shopify recommended its Scripts customizations report to see which customizations could move to Shopify Functions or to public apps.[3] Today the Help Center states that Scripts and the Script Editor app "were retired on June 30, 2026, and scripts no longer run on any store", and the old Script Editor help pages redirect to the page about app extensions and functions. For discounts, shipping and delivery options and payment methods, Shopify tells merchants to use an app that provides functions.[4]
Migration map: which Function API replaces each script type
There is no one-to-one converter. Each job a script did maps to a specific Function API:
| Script type | Typical job | Replacement |
|---|---|---|
| Line item | Tiered, volume and customer-tag discounts | Discount Function API, which can apply savings to products, the order and shipping, and lists tiered discounts as a use case[5] |
| Line item | Bundles, or changing a line's price, title or image | Cart Transform Function API; the update operations need Plus or a development store[6] |
| Line item | Quantity limits and other rules a cart must meet | Cart and Checkout Validation Function API[7] |
| Shipping | Rename, hide or reorder rates | Delivery Customization Function API[8] |
| Shipping | Discounted or free shipping | Discount Function API, shipping class[5] |
| Payment | Rename, hide or reorder payment methods | Payment Customization Function API, which can also set payment terms[9] |
Functions ship inside apps. Stores on any plan can use public App Store apps that contain functions, while custom apps with functions need Shopify Plus.[10] For a Plus store that means two routes: install a public app that already does the job, or commission a custom app with your own functions. Validation rules, which scripts often faked by editing the cart, now have a proper API; we walk through one in our post on custom checkout validation with Shopify Functions.
Example: migrating a tiered discount script
Take a hypothetical Plus store selling coffee equipment. Its line item script gave 5% off every line when the cart reached €100 and 10% off from €200, and skipped customers tagged "wholesale", who already had their own prices. All numbers here are illustrative.
- Write the rules down. Read the Ruby and turn every branch into a plain sentence, then list test carts at the edges: €99.99, €100, €199.99, €200 and a wholesale customer at €250.
- Pick the API. This is a discount, so it becomes one discount function with two tiers. It uses 1 of the 25 discount functions a store can activate.[5]
- Decide the combinations. The script decided in code whether the tier stacked with a discount code. A function does not: discount functions run concurrently, know nothing about each other, and Shopify combines their results under the combination rules set on each discount.[5] The team has to choose those settings on purpose.
- Test, then switch. Run every test cart on a development store, then activate the discount in production.
What a missed migration cost: on a €200 cart the script took €20 off. After June 30, 2026, with no replacement, that customer paid the full €200 even though the store still advertised the tiers. If 300 orders a month qualified at an average of €12 off, the store was charging customers about €3,600 a month more than its own promotion promised, which mostly shows up as complaints and refunds.
Shopify Scripts vs script tags
The names are close, and both are being retired, but they are different things:
| Shopify Scripts | Script tags | |
|---|---|---|
| What it was | Ruby code that changed cart, shipping and payment logic[1] | JavaScript that an app loads onto the storefront without editing the theme[11] |
| Who used it | Plus merchants, through the Script Editor app | Apps, through the ScriptTag API |
| Status | Retired June 30, 2026[4] | No new script tags since October 1, 2026; they stop running on storefronts on March 1, 2027[11] |
| Replacement | Shopify Functions[4] | App embed blocks in a theme app extension, or web pixels for analytics[11] |
FAQ
Do Shopify Scripts still work?
No. Shopify retired Scripts and the Script Editor app on June 30, 2026, and scripts no longer run on any store. Editing and publishing had already stopped on April 15, 2026.[4][3]
What replaced Shopify Scripts?
Shopify Functions, delivered inside apps. For discounts, shipping and delivery options and payment methods, Shopify points merchants to apps that provide functions.[4]
Do I need Shopify Plus to replace my scripts?
Not always. Any plan can use public App Store apps that contain functions. Only custom apps with your own functions require Shopify Plus.[10]
Which Function API replaces a payment script?
The Payment Customization Function API. It renames, reorders and hides payment methods at checkout, and it can also set payment terms.[9]
Are script tags the same as Shopify Scripts?
No. Script tags are storefront JavaScript loaded by apps. They have their own deprecation: no new ones since October 1, 2026, and they stop running on storefronts on March 1, 2027.[11]
The bottom line
Shopify Scripts were the Plus-only Ruby layer for discounts, shipping and payment rules, and they stopped running on June 30, 2026. Every job they did now belongs to a Function API, delivered through a public app or, on Plus, a custom app. If your store lost a script-based rule, or you want the migration checked against edge cases, our checkout customization team rebuilds script logic as tested functions. For the wider checkout changes of the same period, see our guide to checkout extensibility in 2026.
Article sources
We use primary sources only: official documentation, product pages and laws. Each link was checked on the date shown.
- Shopify on GitHub. Shopify Scripts examples repository (archived). Accessed 18th Nov 2026.
- Shopify Changelog. Shopify Scripts deprecation: editing ends April 15, execution ends June 30, 2026. Accessed 18th Nov 2026.
- Shopify Dev changelog. Shopify Scripts will be deprecated on June 30, 2026. Accessed 18th Nov 2026.
- Shopify Help Center. App extensions and functions. Accessed 18th Nov 2026.
- Shopify Dev. Discount Function API. Accessed 18th Nov 2026.
- Shopify Dev. Cart Transform Function API. Accessed 18th Nov 2026.
- Shopify Dev. Cart and Checkout Validation Function API. Accessed 18th Nov 2026.
- Shopify Dev. Delivery Customization Function API. Accessed 18th Nov 2026.
- Shopify Dev. Payment Customization Function API. Accessed 18th Nov 2026.
- Shopify Dev. About Shopify Functions. Accessed 18th Nov 2026.
- Shopify Dev changelog. Script tags are deprecated and will stop running on March 1, 2027. Accessed 18th Nov 2026.
Need this on your store?
See the serviceThe checklist we run before touching a client's code
Get it by email, plus a few short notes over the next two weeks: what we see most often on Shopify stores and what actually fixes it.