Para fijar una cantidad máxima total en WooCommerce, crea una regla combinada de carrito y establece el máximo de unidades. Con un límite de cinco, dos tazas y tres cuadernos alcanzan el tope. No significa cinco unidades de cada producto, cinco líneas distintas ni un importe máximo.
La guía utiliza el paquete público HookSpark Min/Max Quantities 0.13.2 y dos productos simples con existencias suficientes. El ejemplo se comprobó en WordPress y WooCommerce aislados. El límite afecta a un carrito y pedido: no es una cuota personal de por vida ni suma compras de pedidos separados.
Elige el tipo de límite correcto
Antes de abrir los ajustes, decide qué quieres contar. Las unidades son las cantidades del carrito: una línea con tres cuadernos aporta tres. Las líneas distintas son otra cosa: ese carrito puede tener solo dos líneas y contener cinco unidades. El dinero es una métrica diferente.
| Límite | Qué cuenta | Ejemplo |
|---|---|---|
| Por producto | Unidades de ese producto | Hasta cinco tazas; cuadernos por separado |
| Carrito combinado | Unidades de los productos contados | Dos tazas y tres cuadernos = cinco |
| Importe | Dinero según la base elegida | Un umbral monetario, no cinco unidades |
La opción nativa Vendido individualmente limita la cantidad de ese artículo por pedido. La documentación del editor aclara que no impide hacer otro pedido. Las existencias controlan la disponibilidad. Ninguno de estos ajustes equivale al límite combinado de cinco unidades de esta guía. No reduzcas el stock a cinco para simular un tope por pedido.
Crea la regla de cinco unidades totales
Instala el paquete Free público y abre HookSpark → Min/Max. Crea una regla con un nombre interno, como “Máximo cinco unidades por pedido”. En la interfaz inglesa elige All cart items, combined como ámbito y Number of pieces como métrica. Fija Maximum pieces en 5. El ámbito combinado es decisivo: una regla individual resuelve otro problema.
En este ejemplo deja vacíos mínimo, tamaño del lote y cantidad inicial. Un campo opcional vacío no añade esa restricción; cero no lo sustituye. La cantidad inicial corresponde a entradas de productos individuales, no rellena un total combinado. Mantén la audiencia sin restricciones y no añadas exenciones ni exclusiones de recuento en la primera prueba.
Revisa la explicación, activa Enable this rule y guarda. Vuelve a abrir la regla y comprueba ámbito, métrica, máximo y activación. La vista previa describe el borrador: no prueba que un carrito cumpla stock, otras reglas ni requisitos del checkout. Pruébalo en staging antes de activar el límite en la tienda pública.
Prueba un carrito mixto con cinco y seis unidades
Añade dos tazas y tres cuadernos. La suma es cinco aunque haya solo dos líneas de producto. El carrito probado aceptó esa combinación. Añadir otro cuaderno mediante la validación normal de WooCommerce se rechazó y el carrito válido de cinco unidades se mantuvo intacto.
Prueba también editar una cantidad existente. Cambiar los cuadernos de tres a cuatro produce seis unidades: el cambio no debe dejar silenciosamente un carrito inválido. La validación clásica y la validación Store API de WooCommerce 11.2 probadas rechazaron esa modificación. Bajar a dos cuadernos daba cuatro unidades; volver a tres devolvía el total a cinco.
Es una comprobación de la regla de cantidad, no un pago completado ni una garantía para todas las integraciones de checkout. El código personalizado, los lotes y los widgets de terceros necesitan pruebas propias. Una modificación programática directa no equivale a una solicitud normal del escaparate.
Revisa exclusiones, otras reglas y audiencia
El ejemplo cuenta todos los artículos y no tiene exclusiones de recuento. Si después excluyes productos, el total validado puede diferir de la cantidad bruta del carrito. No anuncies “máximo cinco artículos” mientras dejas algunos fuera del recuento sin explicar esa excepción.
Busca límites individuales, mínimos, múltiplos y condiciones de audiencia ya activos. El máximo total no los sustituye. Un producto vendido solo en lotes de seis no cabe en un máximo universal de cinco sin cambiar la configuración. Resuelve el conflicto: modificar el mensaje no hace posible la compra.
Repite los recorridos relevantes como invitado y con la cuenta prevista. Prueba tus productos y variaciones, incluidos aquellos cuyo stock imponga un máximo menor. El mensaje debe explicar el total permitido y la corrección necesaria, sin sugerir reserva de stock ni aceptación del pedido.
Preguntas sobre la cantidad máxima por pedido
¿Cinco significa cinco productos distintos?
No. El ejemplo cuenta unidades: dos tazas y tres cuadernos suman cinco en dos líneas.
¿El límite impide compras repetidas?
No. No es una cuota personal que acumule pedidos. El cliente puede realizar otro salvo que otro sistema verificado lo restrinja.
¿Un importe máximo usa la misma métrica?
No. Purchase amount comprueba dinero; Number of pieces comprueba cantidades. Elige la métrica adecuada.
Usa la guía adecuada para cada límite
Limitar la cantidad de cada producto WooCommerce
Establecer una cantidad mínima por producto
Establecer un importe mínimo de pedido WooCommerce
Empieza con el ejemplo de cinco unidades en staging. Guarda una regla combinada, comprueba el límite y la recuperación y después adapta el máximo a tu necesidad operativa.