RuffRuff Order Limits

(Use Case) Limit Quantity to Multiples of 3

An example that allows customers to buy the same variant only in multiples of 3.

An example that allows customers to buy the same variant only in multiples of 3. Use this when selling in bundle units, such as sets of 3 or sets of 6.

Prerequisite: The initial setup for quantity limits must be complete. If you haven't done this yet, see "Initial Setup (Product Quantity Limits)".

You can check the behavior after setup in [Demo] Quantity Limit in Multiples of 3.

When you enable the quantity rule, it evaluates the total quantity of the same variant in the cart.

  • Total quantity of the same variant is a multiple of 3 (3, 6, 9 items, etc.): purchase is allowed.

  • Total quantity of the same variant is not a multiple of 3 (1, 2, 4, 5 items, etc.): purchase is not allowed.

(1) Add a quantity rule

Open the app admin → "Quantity limits" → "Quantity rules" → "Add quantity rule".

(2) Enter the settings

Configure the following.

Field

Value

Title

Any internal title

Minimum quantity

3

Maximum quantity

Not set

Increment

3

Applicability

Variant

Eligible items

Products or variants to limit by quantity

Product message

Enter if needed

Display timing

Cart updated and checkout

Message for minimum order quantity

Enter if needed

Message for increment of order quantity

Enter if needed

(3) Save and enable the quantity rule

After saving the settings, select "Enable." Saving alone does not apply the quantity limit.

(4) Check the behavior

Add the eligible items to the cart in the quantities above, and check the result when the cart is updated and at checkout.

  • If you also set the minimum quantity to 3, the same as the increment, then 1–2 items are blocked by the minimum quantity check, and quantities like 4–5 items (not a multiple of 3) are blocked by the increment check.

  • You can use {{increment}} in the message for increment of order quantity.

  • If you enable the app embed on the target theme, the quantity picker on the product page also increases and decreases in steps of 3.