Skip to content
Documentation Qtyra Quantity Rules & Tiered Pricing
Configuration

Customer messages

All wording lives under WooCommerce → Settings → Quantity & Pricing → Messages. Leave a field blank to keep the default text. Every message is translatable and can also be overridden with the qmtp_message filter.

Placeholders

Placeholder Replaced with
{product} Product (or variation) name
{qty} Quantity the shopper tried
{min} {max} {step} The rule values
{needed} How many more to reach the minimum
{excess} How many to remove to meet the maximum
{lower} {upper} Nearest valid quantities below / above
{allowed} Comma-separated allowed values (dropdown mode)
{current} Quantity already in the cart
{stock} Available stock
{unit} Unit label (Pro)

Messages and defaults

Message Default
Below minimum The minimum order quantity for “{product}” is {min}{unit}. Please add {needed} more.
Above maximum You can order at most {max}{unit} of “{product}” per order. Please remove {excess}.
Not a multiple of step “{product}” is sold in multiples of {step}{unit}. The nearest valid quantities are {lower} and {upper}.
Value not allowed Please choose one of the available quantities for “{product}”: {allowed}.
Below stock Only {stock}{unit} of “{product}” are available right now.
Stock below minimum “{product}” has a minimum order of {min}{unit}, but only {stock} are currently in stock. Please check back soon.
Cart minimum items (Pro) Your order has {current} items. This store requires at least {min} items per order — please add {needed} more.
Cart maximum items (Pro) Your order has {current} items. The maximum is {max} items per order — please remove {excess}.
Cart minimum subtotal (Pro) Your order subtotal is {current}. The minimum order value is {min} — add {needed} more to check out.
Cart maximum subtotal (Pro) Your order subtotal is {current}. The maximum order value is {max} per order.
Info: The inline hint under the quantity field (“Minimum order: 2 · Sold in multiples of 2”) is generated from the rule and is separate from these error messages.
Was this helpful?