# Quantity Limits (Per-Shipment and Annual)

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 annual (total volume a customer can receive in a

### 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 blocks the checkout and displays a message explaining the restriction.

### Annual Limits

Annual limits cap the total amount of wine a customer can receive in a calendar year from all DTC shippers. CrushSuite tracks customer purchase history to enforce these limits.

If a customer's order would push them over their annual limit, CrushSuite prevents the purchase and explains the restriction.

### 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 checks limits in real time as customers add products to their cart and at pre-checkout.
* 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://crushsuite.gitbook.io/docs/compliance/state-compliance-reference/quantity-limits-per-shipment-and-annual.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
