After Shopify Scripts: Promos on Functions

If your promotions ran on Shopify Scripts, they have already stopped. That is not a forecast: it is the date on Shopify's own pages, and today is past it. This page is for the merchant looking at a store that used to have custom discount logic and now does not. It is a Shopify Scripts replacement guide: it gives the timeline as Shopify published it, what Functions cover, who can use them and on which plans, and three Script-era promotions rebuilt. For a general comparison of native discounts and apps, read Shopify discounts versus an app first; this page picks up where Scripts leave off and does not repeat that checklist.

The Scripts timeline, as Shopify published it

Shopify's developer changelog entry titled "Shopify Scripts will be deprecated on June 30, 2026," posted April 9, 2026, sets two dates. On April 15, 2026, "Editing and publishing new Shopify Scripts will no longer be possible." On June 30, 2026, "All Shopify Scripts will cease to execute entirely." The entry says Shopify is adding discount, shipping and payment capabilities to Shopify Functions so merchants can build the logic they had with Scripts, and it recommends the Shopify Scripts customizations report to see which customizations can move to Functions or public apps.

The Help Center now states it in the past tense: "As of June 30, 2026, Shopify Scripts has been deprecated," and any Scripts that were still published "have been deactivated and no longer work." If a promotion you remember was a Script, it is not running. Check the cart, because a discount that vanished silently is the first sign of this change, and an order placed since the end of June would have been priced without it.

What Scripts did, in Shopify's words

The Help Center's Script Editor page describes three types. Line item scripts "affect line items in a cart and can change prices and grant discounts." Shipping scripts "interact with shipping, and can change shipping methods and grant discounts on shipping rates." Payment scripts "interact with payments, and can rename, hide and re-order payment gateways." Those three types are a useful checklist: for each Script you ran, write down which of the three it was, because that decides what replaces it.

The Shopify Scripts customizations report is, per the Help Center, a personalized page in your admin that is generated automatically. Its job is the inventory step: the changelog says it identifies which customizations can move to Functions or public apps. Start there instead of from memory.

What Functions cover

Shopify's Functions reference lists the APIs: Discount, which lets you create new types of discounts; Delivery customization; Payment customization; Cart transform; Cart and checkout validation; Order routing; and Fulfillment constraints. It also lists two pickup APIs, the Pickup Point and the Local Pickup delivery option generators. Our reading of the match, and it is ours rather than a Shopify table:

The discount documentation explains the classes: discount classes "define the effect of a discount on a cart," with Order and Product discounts applying to cart lines and Shipping discounts to delivery options. Which class a promotion needs is the first design decision, and it also decides how it combines with other discounts, which our post on discount stacking covers.

Who can use Functions, and on what plan

The reference says public apps distributed through the Shopify App Store can contain functions on any plan, except as noted on individual API pages, and that custom apps containing Function APIs require Shopify Plus. The Help Center adds that custom Functions-based apps must be created with the Dev Dashboard and that Functions-based apps require App Bridge. So there are two routes: install an app from the store that already does what you need, or, on Plus, build your own.

Some limits matter before you plan a rebuild. The Cart Transform reference says each app can install at most one cart transform function per store, that checkout rejects its expand, merge and update operations when a selling plan is present, that subscriptions and pre-orders are not supported, that expand and merge quantities are capped at 2000, and that update operations are limited to Shopify Plus stores (one line on the page also allows development stores). Shopify also recommends Rust for functions, to keep them from failing with large carts. None of these is a reason not to move; each is a reason to test a large cart and a subscription cart before you cut over.

Rebuilding three Script-era promotions

1. A tiered cart discount. A line item Script that gave a percentage off the cart at spend thresholds becomes a cart-level discount. In Freebies Engine by Log Studio Lab the matching template is Cart discount tiers, described in the template index as a discount on the whole cart that grows with spend, with the example of 5 percent off at 100 dollars and 10 percent off at 200. Set the tiers, then test the boundary: a cart one cent under each line and one cent over it. Tiered discounts on Shopify covers the margin check for each step.

2. Buy X get Y with a twist. One common-sounding twist is "the cheapest item is free." The template index has Buy X, get Y, for buying certain products and getting a different one free, and a separate template that discounts the cheapest or the priciest item in the cart, with the example "Buy 3, get the cheapest free." Pick the template by the twist: a fixed pairing uses the first, a cheapest-item rule uses the second. The post on the cheapest item free lists the ways shoppers game that rule.

3. A free gift. A Script that added a gift at a cart value becomes Spend X, get a gift, described as a gift added automatically when shoppers reach a cart value. Test two carts on the line, one just under and one just over, and a third where the shopper removes an item after the gift has been added.

What no promotion app replaces

A payment Script that hid a gateway for certain carts has no promotion equivalent. The Payment customization API is the closest, and none of the templates in our index changes payment methods. If your Script was in that group, treat it as a separate project, possibly one for a developer on Plus.

A cutover checklist

• Run the Scripts customizations report and write each item next to its Script type.
• Decide, for each, whether an app covers it or a custom Function is needed, and note the plan the route needs.
• Rebuild the promotion, and set up two test carts for every threshold.
• Test stacking: the new discount with a code, and with an automatic discount.
• Test a large cart and, if you sell subscriptions, a subscription cart.
• Place a real order and read the discount lines in the cart, at checkout and in the order.

Where Freebies Engine by Log Studio Lab fits

The three rebuilds above are the part of Scripts that was a promotion, and they are templates in the index: cart discount tiers, buy X get Y and cheapest-item discounts, and spend-and-get gifts. Plan requirements are printed by the call-to-action below. Start with Cart discount tiers if your Script was a tier on the whole cart, since the template is the simplest of the three to test.