Skip to content

What Were Shopify Scripts?

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:

DateWhat happened
September 3, 2024Shopify 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, 2026Shopify's merchant changelog set the final schedule and told Plus merchants to migrate to Shopify Functions or a public app.[2]
April 15, 2026Editing and publishing new Shopify Scripts was no longer possible.[3][2]
June 30, 2026All 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 typeTypical jobReplacement
Line itemTiered, volume and customer-tag discountsDiscount Function API, which can apply savings to products, the order and shipping, and lists tiered discounts as a use case[5]
Line itemBundles, or changing a line's price, title or imageCart Transform Function API; the update operations need Plus or a development store[6]
Line itemQuantity limits and other rules a cart must meetCart and Checkout Validation Function API[7]
ShippingRename, hide or reorder ratesDelivery Customization Function API[8]
ShippingDiscounted or free shippingDiscount Function API, shipping class[5]
PaymentRename, hide or reorder payment methodsPayment 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.

  1. 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.
  2. 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]
  3. 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.
  4. 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 ScriptsScript tags
What it wasRuby code that changed cart, shipping and payment logic[1]JavaScript that an app loads onto the storefront without editing the theme[11]
Who used itPlus merchants, through the Script Editor appApps, through the ScriptTag API
StatusRetired June 30, 2026[4]No new script tags since October 1, 2026; they stop running on storefronts on March 1, 2027[11]
ReplacementShopify 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.

  1. Shopify on GitHub. Shopify Scripts examples repository (archived). Accessed 18th Nov 2026.
  2. Shopify Changelog. Shopify Scripts deprecation: editing ends April 15, execution ends June 30, 2026. Accessed 18th Nov 2026.
  3. Shopify Dev changelog. Shopify Scripts will be deprecated on June 30, 2026. Accessed 18th Nov 2026.
  4. Shopify Help Center. App extensions and functions. Accessed 18th Nov 2026.
  5. Shopify Dev. Discount Function API. Accessed 18th Nov 2026.
  6. Shopify Dev. Cart Transform Function API. Accessed 18th Nov 2026.
  7. Shopify Dev. Cart and Checkout Validation Function API. Accessed 18th Nov 2026.
  8. Shopify Dev. Delivery Customization Function API. Accessed 18th Nov 2026.
  9. Shopify Dev. Payment Customization Function API. Accessed 18th Nov 2026.
  10. Shopify Dev. About Shopify Functions. Accessed 18th Nov 2026.
  11. 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 service

The 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.

No spam. Unsubscribe anytime. Privacy Policy