Saltar al contenido

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)
  1. Qué pasó con Shopify Scripts
  2. Qué son las Shopify Functions de descuento
  3. Varios descuentos de producto en la misma línea
  4. combinesWith: con qué se combina cada descuento
  5. Migrar una promoción de Scripts paso a paso
  6. Probar en una tienda de desarrollo
  7. Errores comunes
  8. Preguntas frecuentes
  9. Checklist

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.

FechaQué pasóDónde lo dice Shopify
15 abr 2026Ya no se pueden editar ni publicar Scripts.Changelog del 9 de abril
30 abr 2026Admin API 2026-04: varios descuentos de producto en la misma línea.Changelog del 30 de abril
30 jun 2026Todos los Scripts dejan de ejecutarse.Changelog del 9 de abril
10 sep 2026Se 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.

una línea, dos descuentos: el porcentaje va antes que el monto fijocamiseta × 3$300.0010% por volumen−$30.00Function · tag volumede $300.00$20 de lealtad−$20.00otro descuento · tag loyaltyde $270.00total de la línea$250.00etiquetas recíprocasvolumeloyaltyloyaltyvolumecada uno aceptala etiqueta del otrorequisitosShopify PlusAdmin API 2026-04productDiscounts: trueporcentaje primero, monto fijo sobre el precio ya rebajadoejemplo ilustrativo · orden de cálculo según el Centro de ayuda de Shopify

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:

CampoTipoQué controla
productDiscountsBoolean, false por defectoSi se combina con descuentos de clase producto.
orderDiscountsBoolean, false por defectoSi se combina con descuentos de clase pedido.
shippingDiscountsBoolean, false por defectoSi 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
  1. TAG y TIERS son la configuración, escrita como constantes: cambiar un nivel era editar y volver a publicar el Script.
  2. El bucle recorre cada línea del carrito y salta las tarjetas de regalo y los productos sin la etiqueta.
  3. TIERS.find toma el primer nivel que alcanza la cantidad de la línea; por eso el de 6 va primero.
  4. change_line_price cambia el precio de la línea y le pone un mensaje. El Script no creaba un descuento: reescribía el precio.
  5. Output.cart = Input.cart devuelve 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
  1. --template discount usa la plantilla de la Discount Function API.
  2. --flavor vanilla-js elige JavaScript; la CLI también acepta typescript y rust, entre otros.
  3. --name es el nombre de la extensión; la CLI la crea en una carpeta dentro de extensions/.

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
    }
  }
}
  1. query CartInput es el nombre que usa la plantilla de JavaScript.
  2. De cada línea pedimos id, para apuntar el descuento, y quantity, para elegir el nivel.
  3. merchandise puede ser una variante u otro tipo de mercancía; __typename dice cuál.
  4. Las etiquetas no se leen como lista: hasAnyTag devuelve true si el producto tiene alguna de las que pasas. isGiftCard reemplaza al gift_card? del Script.
  5. discountClasses dice con qué clases se creó el descuento.
  6. El metafield volume-tiers del descuento, en el namespace $app, guarda los niveles como JSON; jsonValue te 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" } }],
  };
}
  1. DEFAULT_TIERS son los mismos niveles del Script. Si el descuento tiene el metafield, mandan sus niveles; así el comerciante los cambia sin desplegar código.
  2. Si el descuento no incluye la clase PRODUCT, devolvemos { operations: [] }: no hay nada que hacer.
  3. Ordenamos los niveles de mayor a menor cantidad mínima, para que find tome el más alto que se alcanza sin importar el orden del JSON.
  4. Saltamos lo que no es una variante, las tarjetas de regalo y los productos sin la etiqueta.
  5. Por cada línea que califica agregamos un candidato: su cartLine, el porcentaje como texto con toFixed(1) y el mensaje que verá el cliente.
  6. Sin candidatos no hay operación. Con candidatos, una sola productDiscountsAdd con selectionStrategy: "ALL": cada línea tiene su propio candidato y queremos que se apliquen todos. Con FIRST, 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"
  1. 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.
  2. handle identifica la Function; lo usarás como functionHandle al crear el descuento.
  3. El único [[extensions.targeting]] une el target de líneas con su query y con el export cart-lines-discounts-generate-run, que corresponde a la función cartLinesDiscountsGenerateRun.
  4. [extensions.build] queda como en la plantilla: la CLI compila el JavaScript a dist/function.wasm.
de un Script de Ruby a una Function de descuento, en seis pasoslee el Script y escribe la regla en prosabulk-tier: 3+ = 10%, 6+ = 15%genera la extensión de descuentoshopify app generate extension --template discount --flavor vanilla-jspide solo los datos que usa: input queryquantity · hasAnyTag(tags: ["bulk-tier"]) · metafielddevuelve candidatos, no preciosproductDiscountsAdd · selectionStrategy: ALLcrea el descuento y con qué combinadiscountAutomaticAppCreate · discountClasses · combinesWithprueba en una tienda de desarrolloshopify app dev · shopify app function replayla regla no cambia; cambia quién aplica el descuentola función se probó en Node con 5 carritos de ejemplo

Desliza la figura para verla completa

la misma promoción de descuento en Scripts y en FunctionsScriptsFunctionslenguajeRubyJavaScript, TypeScript, Rustdónde viveScript Editor (app)extensión de una appla promociónchange_line_priceproductDiscountsAddsalidaOutput.cartoperations (JSON)configuraciónconstantes en el códigometafield del descuentoestadoapagados: 30 jun 2026API 2026-10un Script cambiaba el precio; una Function devuelve descuentoslas Functions también cubren envíos y pagos; aquí solo descuentos

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 }
}
  1. Las líneas 1 y 2 tienen la etiqueta y 6 y 3 unidades: deberían recibir 15% y 10%.
  2. La 3 es una tarjeta de regalo, la 4 tiene 1 unidad y la 5 no es una variante (CustomProduct, sin product): ninguna debe recibir nada.
  3. "metafield": null simula 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}%`));
}
  1. Importa la función directamente, sin compilarla; la plantilla ya trae "type": "module" en package.json.
  2. 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%' ]
  1. cart-config: el metafield trae un solo nivel (2 o más, 5%) y manda sobre los niveles por defecto.
  2. cart-mixed: solo las líneas 1 y 2 reciben candidato, con 15% y 10%.
  3. cart-no-match y cart-order-only: la función devuelve { operations: [] }; en el segundo, porque el descuento no tiene la clase PRODUCT.
  4. 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
  1. --input le pasa el JSON del carrito; si lo omites, lo lee de la entrada estándar.
  2. --export es el valor de export del 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
    }
  }
}
  1. functionHandle es el handle del TOML.
  2. discountClasses: [PRODUCT] hace que solo corra el target de líneas y que la función devuelva descuentos de producto.
  3. tags: ["volume"] es la etiqueta propia de este descuento.
  4. combinesWith lo combina con otros descuentos de producto y, en la misma línea, con los que tengan la etiqueta loyalty.
  5. metafields guarda los niveles en $app / volume-tiers, el metafield que lee la query. Para cambiarlos, actualizas este valor; no hace falta desplegar.
  6. Revisa userErrors. Si dice «Could not find Function», el tutorial indica revisar que app dev siga corriendo, que el handle sea correcto y que la app tenga el permiso write_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 FIRST con un candidato por línea. Solo se aplica el primero. Si cada línea tiene su candidato, usa ALL.
  • Crear el descuento sin la clase PRODUCT. discountClasses decide qué targets corren; con solo ORDER, esta función no devuelve nada.
  • Escribir los decimales como números. La referencia documenta el texto: "15.0".
  • Pedir tags del producto en la query. El esquema no lo tiene; usa hasAnyTag o hasTags.
  • Configurar etiquetas en una sola dirección. Cada descuento tiene que aceptar una etiqueta del otro.
  • Actualizar tags para agregar una etiqueta. Reemplaza las anteriores; usa tagsAdd.
  • 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 ALL si 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, combinesWith y 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

Luis Morales

Luis Morales

Desarrollador frontend y Shopify, EcomLabs

@luismoralesdev en Instagram

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

← Blog