> For the complete documentation index, see [llms.txt](https://crushsuite.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://crushsuite.gitbook.io/docs/compliance/state-compliance-reference/quantity-limits-per-shipment-and-monthly.md).

# Quantity Limits (Per-Shipment and Monthly)

Many states cap how much wine a consumer can receive via DTC shipping. Limits come in two forms: per-shipment (how many bottles in a single order) and volume limits over a rolling period — most commonly a **calendar month**, not a year. In most states Vinoshipper enforces the monthly cap at **9 litres, equal to 12 × 750ml bottles, per customer per calendar month**.

### Per-Shipment Limits

Per-shipment limits restrict the quantity of alcohol in a single order. These are typically measured in cases (a case = 12 standard 750ml bottles) or gallons.

When a customer's cart exceeds the per-shipment limit for their state, CrushSuite attempts to flag the restriction before checkout. This is a best-effort check — it is not a guaranteed block. Carts that exceed a state limit can and do complete checkout, in which case the violation surfaces afterward as an order issue from Vinoshipper. See Handling Failed or Blocked Orders.

### Monthly Volume Limits

Volume limits cap the total amount of wine a customer can receive from all DTC shippers over a set period. For most states this period is a **calendar month**, and the cap is **9 litres (12 × 750ml bottles)**. **CrushSuite does not track customer purchase history.** Cumulative volume is tracked and enforced by Vinoshipper, based on the full picture of what that customer has received across all shippers — data CrushSuite does not have access to.

Because cumulative volume lives in Vinoshipper and not in CrushSuite, an order that pushes a customer over their monthly limit will usually complete checkout normally. Vinoshipper then rejects it and returns an order issue — typically worded *"can not be more than 9L (12x750ml bottles) in a calendar month."* You will see this in CrushSuite under Orders, and you will need to contact the customer to reduce or split the order.

####

### How CrushSuite Handles Quantity Limits

* Limits are configured per state in your compliance settings (via Vinoshipper sync or manual entry).
* CrushSuite calculates quantities based on 750ml equivalents (a 1.5L bottle counts as 2 units).
* The compliance engine evaluates the **current cart** against per-shipment limits as customers add products and at pre-checkout. It does not evaluate the customer's prior order history, so cumulative monthly limits cannot be enforced at this stage.
* Minimum order quantities are also supported (e.g., requiring at least 1 bottle per order).

### Merchant Configuration

You can also set merchant-level minimum and maximum order quantities:

* **Minimum order quantity** — The minimum number of 750ml-equivalent bottles required per order (default: 1)
* **Maximum order quantity** — The maximum number of bottles per order (optional)

These stack with state-level limits — the more restrictive limit applies.

> 📸 **Screenshot:** State configuration screen showing quantity limit settings