Migrar Shopify Scripts a Functions: tus descuentos, paso a paso
Actualización/ 19 min de lectura
Los Scripts dejaron de ejecutarse el 30 de junio de 2026. Cómo rehacer una promoción por volumen como Function de descuento y apilar descuentos en una línea desde la API 2026-04.
- Shopify Functions
- Shopify Plus
- Checkout
- Migración
En este artículo (9)
Para migrar Shopify Scripts a Functions, reescribe cada promoción como una Function de descuento: una input query, una función que devuelve candidatos y un descuento creado con sus reglas de combinación. Los Scripts dejaron de ejecutarse el 30 de junio de 2026, y desde la API 2026-04 varios descuentos pueden compartir una línea en Plus.
Aquí tienes qué publicó Shopify y en qué fechas, qué es una Function de descuento, cómo funcionan los descuentos apilados en una línea y combinesWith, y la migración completa de una promoción real de Scripts: un descuento por volumen que pasamos a JavaScript y probamos en Node con cinco carritos. Si todavía dudas de que tu caso pida una Function, empieza por cuándo usar Shopify Functions.
Qué pasó con Shopify Scripts
El 9 de abril de 2026, Shopify publicó en su changelog «Shopify Scripts will be deprecated on June 30, 2026», con dos fechas distintas: desde el 15 de abril ya no se podían editar ni publicar Scripts, y el 30 de junio todos dejaron de ejecutarse. La página del Centro de ayuda que enlazaba, hoy titulada App extensions and functions, ya lo dice en pasado: los scripts no se ejecutan en ninguna tienda. Si una promoción vivía en un Script y nadie la migró, desde el 1 de julio el checkout cobra sin ella.
El 30 de abril, el changelog anunció «Multiple product discounts can apply on a single cart line»: desde la versión 2026-04 de la GraphQL Admin API, varios descuentos de producto pueden aplicarse a la misma línea, para que los comerciantes sigan migrando sus Scripts antes del cierre. Y el 10 de septiembre, Shopify cerró la vista previa de la Discounts Allocator Function API, que no se publicará: el reparto de descuentos se queda en la plataforma. Si tu app declara el target purchase.discounts-allocator.run, quítalo, o shopify app deploy falla para toda la app.
| Fecha | Qué pasó | Dónde lo dice Shopify |
|---|---|---|
| 15 abr 2026 | Ya no se pueden editar ni publicar Scripts. | Changelog del 9 de abril |
| 30 abr 2026 | Admin API 2026-04: varios descuentos de producto en la misma línea. | Changelog del 30 de abril |
| 30 jun 2026 | Todos los Scripts dejan de ejecutarse. | Changelog del 9 de abril |
| 10 sep 2026 | Se cierra la vista previa del Discounts Allocator; el reparto queda en la plataforma. | Changelog del 10 de septiembre |
Actualizado el 11 de noviembre de 2026: el aviso de abril recomendaba el informe de personalizaciones de Scripts y una guía de migración en el Centro de ayuda; hoy esa página ya no menciona el informe y solo confirma la retirada. La referencia actual de la Discount Function API es la versión 2026-10, la misma que usa el tutorial oficial y la que usamos aquí.
No confundas los Scripts de Ruby con los script tags: son otra retirada, con otro calendario, y la explicamos en Shopify Scripts y los script tags tienen fechas de retiro distintas.
Qué son las Shopify Functions de descuento
Una Function de descuento es una extensión de app que Shopify ejecuta en sus servidores cada vez que calcula un carrito. No le das un precio nuevo a la línea, como hacía un Script: devuelves operaciones y Shopify decide cómo aplicarlas. La referencia de la Discount Function API tiene dos targets de ejecución: cart.lines.discounts.generate.run, para líneas y subtotal del pedido, y cart.delivery-options.discounts.generate.run, para envíos. Los targets fetch, con acceso a red, son solo para apps personalizadas en tiendas Shopify for enterprise; para migrar un Script no hacen falta.
Qué target corre lo decide el descuento, no tu código: según la documentación de descuentos, el campo discountClasses del descuento determina qué targets se ejecutan. Las clases PRODUCT y ORDER salen del target de líneas; SHIPPING, del de envíos.
Cada target tiene una input query (los datos que usa tu lógica; lo que no pidas no existe para tu función), la función (en JavaScript, cartLinesDiscountsGenerateRun) y lo que devuelve: operaciones como productDiscountsAdd u orderDiscountsAdd, con candidatos. Un candidato dice a qué se aplica (una cartLine, el orderSubtotal o una deliveryOption), cuánto (percentage o fixedAmount) y qué mensaje ve el cliente. En descuentos de producto, la selectionStrategy puede ser FIRST (el primer candidato), MAXIMUM (la mayor rebaja) o ALL (todos, sin pasar por encima de las reglas de combinación). Los decimales se escriben como texto: "10.0".
Tres límites de la referencia: una Function de descuento solo controla los descuentos que crea, no los nativos ni los de otras apps; las Functions corren en paralelo y no saben unas de otras; y si una ejecución falla, Shopify descarta su salida, no aplica el descuento y el checkout sigue.
Varios descuentos de producto en la misma línea
Por defecto, una línea del carrito recibe un solo descuento de producto. Si dos descuentos califican para la misma camiseta, se aplica uno. Para muchas promociones que venían de Scripts eso era un bloqueo, y es lo que cambió con la API 2026-04.
La pieza nueva es el campo productDiscountsWithTagsOnSameCartLine dentro de combinesWith. Las reglas, según la referencia de la Admin API:
- Solo está disponible en el plan Shopify Plus y exige
productDiscounts: true. El changelog no menciona Plus; la referencia y el Centro de ayuda, sí. - Funciona con etiquetas en las dos direcciones. Cada descuento tiene sus propias etiquetas (el campo
tags) y una lista de etiquetas con las que acepta compartir línea. Dos descuentos se aplican juntos solo si cada uno acepta al menos una etiqueta que tiene el otro. - En una línea se pueden apilar los descuentos que quieras, siempre que cada par cumpla esa regla.
- En un descuento Buy X Get Y solo se apilan los productos que el cliente recibe, no los que compra.
¿En qué orden se calculan? El Centro de ayuda, en Combining discounts, dice que primero van los descuentos de producto, después los de pedido y al final los de envío. En un mismo artículo, los porcentajes se aplican antes que los montos fijos, y el monto fijo se resta del precio ya rebajado. Su ejemplo: un pantalón de $100 con 10% de descuento en ropa queda en $90, y un descuento de $20 en pantalones lo deja en $70.
Desliza la figura para verla completa
Lo importante para tu Function: este cambio está en la configuración del descuento, no en lo que devuelve la función. Tu código sigue devolviendo sus candidatos igual que antes. Si comparten línea con otro descuento lo deciden combinesWith y las etiquetas de cada uno.
En el admin, los pasos son: abre el descuento, agrega una etiqueta en Tags, en Combinations marca Product discounts, cambia One per product por Multiple per product y elige en Combine on same product with discounts tagged las etiquetas con las que se combina. El otro descuento necesita la configuración recíproca.
combinesWith: con qué se combina cada descuento
Todo descuento, nativo o de app, tiene su combinesWith. En DiscountCombinesWithInput (API 2026-04) son cuatro campos:
| Campo | Tipo | Qué controla |
|---|---|---|
productDiscounts | Boolean, false por defecto | Si se combina con descuentos de clase producto. |
orderDiscounts | Boolean, false por defecto | Si se combina con descuentos de clase pedido. |
shippingDiscounts | Boolean, false por defecto | Si se combina con descuentos de envío. |
productDiscountsWithTagsOnSameCartLine | { add, remove } | Con qué etiquetas acepta compartir la misma línea. Solo Plus; exige productDiscounts: true. |
add y remove cambian la lista de etiquetas aceptadas, no las etiquetas del descuento. Esas van en el campo tags de DiscountAutomaticAppInput o del input del descuento que estés creando. Cuidado: actualizar tags reemplaza las que había; para sumar sin borrar, la referencia indica la mutación tagsAdd.
Dos reglas más del Centro de ayuda aplican a los descuentos de app: si una app crea un descuento con varias clases, solo se combina con descuentos que acepten todas esas clases, y una tienda puede tener hasta 25 descuentos automáticos activos, contando los de apps. Escribe la combinación antes de programar: ¿esta promoción se suma al código de la newsletter? ¿Y al descuento de lealtad, en la misma línea?
Migrar una promoción de Scripts paso a paso
La promoción de ejemplo es de las más comunes en Scripts de line items: descuento por volumen en productos con una etiqueta. Con 3 a 5 unidades en una línea, 10%; con 6 o más, 15%; nunca en tarjetas de regalo. Este es el Script, escrito con las mismas llamadas que usan los ejemplos de Scripts que Shopify archivó en GitHub. Ya no se puede ejecutar en ninguna tienda, así que no lo corrimos:
TAG = 'bulk-tier'
TIERS = [
{ min_quantity: 6, percentage: 15 },
{ min_quantity: 3, percentage: 10 },
]
Input.cart.line_items.each do |line_item|
product = line_item.variant.product
next if product.gift_card?
next unless product.tags.include?(TAG)
tier = TIERS.find { |t| line_item.quantity >= t[:min_quantity] }
next if tier.nil?
line_item.change_line_price(
line_item.line_price * (1.0 - tier[:percentage] / 100.0),
message: "#{tier[:percentage]}% off for #{tier[:min_quantity]}+"
)
end
Output.cart = Input.cart
TAGyTIERSson la configuración, escrita como constantes: cambiar un nivel era editar y volver a publicar el Script.- El bucle recorre cada línea del carrito y salta las tarjetas de regalo y los productos sin la etiqueta.
TIERS.findtoma el primer nivel que alcanza la cantidad de la línea; por eso el de 6 va primero.change_line_pricecambia el precio de la línea y le pone un mensaje. El Script no creaba un descuento: reescribía el precio.Output.cart = Input.cartdevuelve el carrito modificado.
Paso 1: escribe la regla en prosa
Antes de abrir la terminal: «Productos con la etiqueta bulk-tier: 10% con 3 a 5 unidades en la línea y 15% con 6 o más; nunca tarjetas de regalo; se combina con el descuento de lealtad en la misma línea». La última frase no estaba en el Script y ahora es configuración del descuento, no código.
Paso 2: genera la extensión
Desde la carpeta de tu app, con la Shopify CLI:
shopify app generate extension --template discount --flavor vanilla-js --name volume-discount
--template discountusa la plantilla de la Discount Function API.--flavor vanilla-jselige JavaScript; la CLI también aceptatypescriptyrust, entre otros.--namees el nombre de la extensión; la CLI la crea en una carpeta dentro deextensions/.
La plantilla de JavaScript trae los dos targets. Esta promoción solo usa el de líneas, así que quitamos el de envíos, como hace Shopify en su tutorial Build a Discount Function that rejects invalid codes: fuera su bloque del TOML, sus dos archivos src/cart_delivery_options* y su línea en src/index.js.
Paso 3: la input query
En src/cart_lines_discounts_generate_run.graphql:
query CartInput {
cart {
lines {
id
quantity
merchandise {
__typename
... on ProductVariant {
product {
isGiftCard
hasAnyTag(tags: ["bulk-tier"])
}
}
}
}
}
discount {
discountClasses
metafield(namespace: "$app", key: "volume-tiers") {
jsonValue
}
}
}
query CartInputes el nombre que usa la plantilla de JavaScript.- De cada línea pedimos
id, para apuntar el descuento, yquantity, para elegir el nivel. merchandisepuede ser una variante u otro tipo de mercancía;__typenamedice cuál.- Las etiquetas no se leen como lista:
hasAnyTagdevuelvetruesi el producto tiene alguna de las que pasas.isGiftCardreemplaza algift_card?del Script. discountClassesdice con qué clases se creó el descuento.- El metafield
volume-tiersdel descuento, en el namespace$app, guarda los niveles como JSON;jsonValuete lo entrega ya convertido.
Paso 4: la función
En src/cart_lines_discounts_generate_run.js:
// The tiers the Script had as constants. A "volume-tiers" metafield on the discount overrides them.
const DEFAULT_TIERS = [
{ minQuantity: 6, percentage: 15 },
{ minQuantity: 3, percentage: 10 },
];
export function cartLinesDiscountsGenerateRun(input) {
if (!input.discount.discountClasses.includes("PRODUCT")) {
return { operations: [] };
}
const tiers = [...(input.discount.metafield?.jsonValue?.tiers ?? DEFAULT_TIERS)]
.sort((a, b) => b.minQuantity - a.minQuantity);
const candidates = [];
for (const line of input.cart.lines) {
if (line.merchandise.__typename !== "ProductVariant") continue;
const { product } = line.merchandise;
if (product.isGiftCard || !product.hasAnyTag) continue;
const tier = tiers.find((t) => line.quantity >= t.minQuantity);
if (!tier) continue;
candidates.push({
message: `${tier.percentage}% off for ${tier.minQuantity}+`,
targets: [{ cartLine: { id: line.id } }],
value: { percentage: { value: tier.percentage.toFixed(1) } },
});
}
if (candidates.length === 0) {
return { operations: [] };
}
return {
operations: [{ productDiscountsAdd: { candidates, selectionStrategy: "ALL" } }],
};
}
DEFAULT_TIERSson los mismos niveles del Script. Si el descuento tiene el metafield, mandan sus niveles; así el comerciante los cambia sin desplegar código.- Si el descuento no incluye la clase
PRODUCT, devolvemos{ operations: [] }: no hay nada que hacer. - Ordenamos los niveles de mayor a menor cantidad mínima, para que
findtome el más alto que se alcanza sin importar el orden del JSON. - Saltamos lo que no es una variante, las tarjetas de regalo y los productos sin la etiqueta.
- Por cada línea que califica agregamos un candidato: su
cartLine, el porcentaje como texto contoFixed(1)y el mensaje que verá el cliente. - Sin candidatos no hay operación. Con candidatos, una sola
productDiscountsAddconselectionStrategy: "ALL": cada línea tiene su propio candidato y queremos que se apliquen todos. ConFIRST, solo se aplicaría el primero.
La plantilla importa DiscountClass y las estrategias desde ../generated/api, un archivo que genera shopify app function typegen. Aquí escribimos esos mismos valores como texto para poder correr la función en Node sin ese paso.
Paso 5: el archivo de la extensión
El shopify.extension.toml, sin el target de envíos:
api_version = "2026-10"
[[extensions]]
name = "t:name"
handle = "volume-discount"
type = "function"
description = "t:description"
[[extensions.targeting]]
target = "cart.lines.discounts.generate.run"
input_query = "src/cart_lines_discounts_generate_run.graphql"
export = "cart-lines-discounts-generate-run"
[extensions.build]
command = ""
path = "dist/function.wasm"
api_version = "2026-10"es la versión de la Discount Function API. El tutorial oficial usa la 2026-10; la plantilla de GitHub todavía trae la 2026-07.handleidentifica la Function; lo usarás comofunctionHandleal crear el descuento.- El único
[[extensions.targeting]]une el target de líneas con su query y con el exportcart-lines-discounts-generate-run, que corresponde a la funcióncartLinesDiscountsGenerateRun. [extensions.build]queda como en la plantilla: la CLI compila el JavaScript adist/function.wasm.
Desliza la figura para verla completa
Desliza la figura para verla completa
Probar en una tienda de desarrollo
Primero, en Node
La función es pura: entra JSON, sale JSON. Antes de compilar nada puedes llamarla en Node con carritos de ejemplo. Guarda cada carrito en inputs/ con la forma exacta que devuelve tu query. Este es el carrito con varias líneas, inputs/cart-mixed.json:
{
"cart": {
"lines": [
{ "id": "gid://shopify/CartLine/1", "quantity": 6,
"merchandise": { "__typename": "ProductVariant", "product": { "isGiftCard": false, "hasAnyTag": true } } },
{ "id": "gid://shopify/CartLine/2", "quantity": 3,
"merchandise": { "__typename": "ProductVariant", "product": { "isGiftCard": false, "hasAnyTag": true } } },
{ "id": "gid://shopify/CartLine/3", "quantity": 10,
"merchandise": { "__typename": "ProductVariant", "product": { "isGiftCard": true, "hasAnyTag": true } } },
{ "id": "gid://shopify/CartLine/4", "quantity": 1,
"merchandise": { "__typename": "ProductVariant", "product": { "isGiftCard": false, "hasAnyTag": true } } },
{ "id": "gid://shopify/CartLine/5", "quantity": 8,
"merchandise": { "__typename": "CustomProduct" } }
]
},
"discount": { "discountClasses": ["PRODUCT"], "metafield": null }
}
- Las líneas 1 y 2 tienen la etiqueta y 6 y 3 unidades: deberían recibir 15% y 10%.
- La 3 es una tarjeta de regalo, la 4 tiene 1 unidad y la 5 no es una variante (
CustomProduct, sinproduct): ninguna debe recibir nada. "metafield": nullsimula un descuento sin configuración: se usan los niveles por defecto.
Los otros cuatro carritos (están en la guía) cubren una línea que califica, una que no, un metafield con otro nivel y un descuento solo de clase ORDER. Este run-carts.mjs, junto a package.json, los corre todos:
import { readdirSync, readFileSync } from "node:fs";
import { cartLinesDiscountsGenerateRun } from "./src/cart_lines_discounts_generate_run.js";
for (const file of readdirSync("inputs")) {
const input = JSON.parse(readFileSync(`inputs/${file}`, "utf8"));
const { operations } = cartLinesDiscountsGenerateRun(input);
const candidates = operations[0]?.productDiscountsAdd.candidates ?? [];
console.log(file, candidates.map((c) => `${c.targets[0].cartLine.id} ${c.value.percentage.value}%`));
}
- Importa la función directamente, sin compilarla; la plantilla ya trae
"type": "module"enpackage.json. - Lee cada JSON de
inputs/, llama a la función e imprime qué línea recibe qué porcentaje, o una lista vacía.
Esta es la salida real, con Node 22.22.3 en Windows 11:
$ node run-carts.mjs
cart-config.json [ 'gid://shopify/CartLine/1 5.0%' ]
cart-mixed.json [ 'gid://shopify/CartLine/1 15.0%', 'gid://shopify/CartLine/2 10.0%' ]
cart-no-match.json []
cart-order-only.json []
cart-qualifies.json [ 'gid://shopify/CartLine/1 10.0%' ]
cart-config: el metafield trae un solo nivel (2 o más, 5%) y manda sobre los niveles por defecto.cart-mixed: solo las líneas 1 y 2 reciben candidato, con 15% y 10%.cart-no-matchycart-order-only: la función devuelve{ operations: [] }; en el segundo, porque el descuento no tiene la clasePRODUCT.cart-qualifies: 4 unidades con la etiqueta, 10%.
Además validamos la query contra los esquemas 2026-04 y 2026-07 de la Discount Function API, y comprobamos que cada carrito tiene la forma exacta que devuelve esa query y que cada salida es un CartLinesDiscountsGenerateRunResult válido.
El siguiente paso local es correr la función ya compilada con la Shopify CLI, desde la carpeta de la extensión:
shopify app function run --input inputs/cart-mixed.json --export cart-lines-discounts-generate-run
--inputle pasa el JSON del carrito; si lo omites, lo lee de la entrada estándar.--exportes el valor deexportdel TOML.
Este comando no lo ejecutamos: corre dentro del proyecto de una app de la CLI, y para este artículo no creamos ninguna app ni conectamos ninguna tienda.
Después, en una tienda de desarrollo
Para probar varios descuentos en la misma línea necesitas Plus. Desde el Dev Dashboard puedes crear una tienda de desarrollo y elegir su plan, Plus incluido. Las tiendas de desarrollo no procesan transacciones reales; para pagar usas el Test payment gateway. Siguiendo el tutorial de Discount Function: corre shopify app dev, presiona g en esa terminal para abrir GraphiQL, elige la versión estable más reciente y crea el descuento:
mutation CreateVolumeDiscount {
discountAutomaticAppCreate(
automaticAppDiscount: {
title: "Volume discount"
functionHandle: "volume-discount"
discountClasses: [PRODUCT]
startsAt: "2026-11-11T00:00:00Z"
tags: ["volume"]
combinesWith: {
productDiscounts: true
productDiscountsWithTagsOnSameCartLine: { add: ["loyalty"] }
}
metafields: [
{
namespace: "$app"
key: "volume-tiers"
type: "json"
value: "{\"tiers\":[{\"minQuantity\":6,\"percentage\":15},{\"minQuantity\":3,\"percentage\":10}]}"
}
]
}
) {
automaticAppDiscount {
discountId
status
combinesWith {
productDiscounts
productDiscountsWithTagsOnSameCartLine
}
}
userErrors {
field
message
}
}
}
functionHandlees elhandledel TOML.discountClasses: [PRODUCT]hace que solo corra el target de líneas y que la función devuelva descuentos de producto.tags: ["volume"]es la etiqueta propia de este descuento.combinesWithlo combina con otros descuentos de producto y, en la misma línea, con los que tengan la etiquetaloyalty.metafieldsguarda los niveles en$app/volume-tiers, el metafield que lee la query. Para cambiarlos, actualizas este valor; no hace falta desplegar.- Revisa
userErrors. Si dice «Could not find Function», el tutorial indica revisar queapp devsiga corriendo, que el handle sea correcto y que la app tenga el permisowrite_discounts.
Después, en el admin, crea el otro descuento de producto (por ejemplo, $20 en camisetas) con la etiqueta loyalty y Multiple per product con descuentos etiquetados volume. Desactiva los demás descuentos y prueba 2, 4 y 6 unidades, y 6 con el descuento de lealtad activo. Revisa cada ejecución en la salida de shopify app dev y repítela con shopify app function replay. Prueba el apilado antes de prometerlo: depende de cómo esté configurado cada descuento.
Errores comunes
- Usar
FIRSTcon un candidato por línea. Solo se aplica el primero. Si cada línea tiene su candidato, usaALL. - Crear el descuento sin la clase
PRODUCT.discountClassesdecide qué targets corren; con soloORDER, esta función no devuelve nada. - Escribir los decimales como números. La referencia documenta el texto:
"15.0". - Pedir
tagsdel producto en la query. El esquema no lo tiene; usahasAnyTagohasTags. - Configurar etiquetas en una sola dirección. Cada descuento tiene que aceptar una etiqueta del otro.
- Actualizar
tagspara agregar una etiqueta. Reemplaza las anteriores; usatagsAdd. - Prometer descuentos apilados sin Plus o sin
productDiscounts: true. El apilado en la misma línea necesita los dos.
Preguntas frecuentes
¿Mis Scripts siguen funcionando?
No. Según el changelog de Shopify, desde el 15 de abril de 2026 no se pueden editar ni publicar, y desde el 30 de junio de 2026 no se ejecuta ninguno. Si una promoción dependía de un Script y no la migraste, hoy no se aplica.
¿Necesito Shopify Plus?
Para varios descuentos de producto en la misma línea, sí: la referencia de la Admin API lo limita al plan Plus. Para la Function en sí depende de cómo la distribuyas, y lo explicamos en cuándo usar Shopify Functions.
¿Puedo escribir la Function en JavaScript?
Sí. La CLI genera la extensión con --flavor vanilla-js, typescript o rust, y compila el JavaScript a WebAssembly. La plantilla de JavaScript de Shopify es la base de este ejemplo.
¿Cómo la pruebo sin tocar la tienda real?
En tres capas: llamando a la función en Node con carritos JSON, con shopify app function run sobre la versión compilada y en una tienda de desarrollo con shopify app dev. Para el apilado en una línea, crea la tienda de desarrollo con el plan Plus.
Checklist
- Tienes la lista de promociones que vivían en Scripts y cada una escrita en prosa.
- La extensión tiene solo los targets que usa y
api_version = "2026-10". - La input query pide solo lo que usa la función y valida contra el esquema.
- La función devuelve decimales como texto y
ALLsi hay un candidato por línea. - Corriste la función en Node con carritos que califican, que no y con varias líneas.
- El descuento se crea con
discountClasses,tags,combinesWithy el metafield de niveles. - Los descuentos que se apilan en una línea tienen etiquetas recíprocas, y la tienda es Plus.
- Probaste en una tienda de desarrollo y revisaste las ejecuciones con
shopify app function replay.
Si quieres que el comerciante edite los niveles desde una pantalla de tu app en vez de una mutación, mira Polaris 2 release candidate para apps de Shopify. Para decidir si una regla pide una Function o algo más simple, lee cuándo una Shopify Function es la herramienta adecuada. Y si tu tienda también usaba script tags, revisa las dos retiradas y sus fechas.
Si la promoción necesita un dato del cliente en el checkout, mira cómo agregar un campo extra con una checkout UI extension.
¿Viste esto en Instagram? Comenta FUNCTIONS en el Reel y te mando la guía.
Escrito por

Publicado el 11 de noviembre de 2026 · actualizado el 18 de noviembre de 2026