How Quantity-Based Fees Work
By default, Canteen fees multiply with quantity. If a customer orders 3 bottles with a $0.10 deposit, the total deposit fee will be $0.30.
Per-Item Fees (Default Behavior)
This is how Canteen works out of the box:
Customer adds 1 bottle → $0.10 fee
Customer adds 5 bottles → $0.50 fee
Customer adds 24-pack → $2.40 fee (if $0.10 per unit)
Fees automatically recalculate when the quantity changes.
One-Time Flat Fee (Per Cart)
If you want to charge a single flat fee regardless of quantity (e.g., a one-time handling fee), you can configure this in your rule settings. The fee will be applied once per cart, not per item.
Tips for Quantity-Based Fees
Multi-packs: If you sell products as multi-packs (e.g., a 6-pack), make sure your fee accounts for the pack size. You may want to set the fee to 6× the per-unit rate for the 6-pack product.
Variants: If your product has variants with different pack sizes, you can assign different fee amounts to each variant.
Mixed carts: Canteen handles mixed carts automatically — each product gets its own applicable fee based on the rules.
Troubleshooting: Fees Stop Applying at Higher Quantities
If your fees work correctly for small quantities but stop applying when the quantity exceeds a certain number (e.g., more than 12 items), check the following:
Maximum quantity conditions: Check if your rule has a maximum quantity condition set. If a rule has a max quantity limit, it will stop applying once the cart exceeds that threshold.
Rule conditions: Review all conditions on the rule — sometimes conditions like "quantity is less than X" can cause fees to drop off at higher quantities.
App embed version: Make sure you are on the latest version of the Canteen app embed (4.1.0+). Older versions may have issues with quantity recalculation at higher numbers.
Still having issues? Send us a message with your store URL, the rule name, and the quantity where fees stop working, and we will investigate.