# Configuring State Shipping Rules

{% hint style="info" %}
**You are here:** Phase 2 of 3 — Configure

You'll need about 5 to 10 minutes for this step. If you're using Vinoshipper, this is mostly a verification step. If you're self-compliance, this is where you configure each state manually.

Next: [Setting Up State Alcohol Fees](/docs/compliance/getting-started/setting-up-state-alcohol-fees.md)
{% endhint %}

## Configuring State Shipping Rules

State shipping rules control which states your winery can legally ship wine to. CrushSuite uses these rules to automatically show or hide products and block checkout for customers in restricted states.

***

### How State Shipping Rules Work

Every U.S. state has its own direct-to-consumer (DTC) shipping laws. Some states allow wine shipments freely, some require specific permits, some have quantity restrictions, and some prohibit DTC wine shipments entirely. CrushSuite's compliance engine enforces these rules at checkout so you don't have to worry about accidentally shipping to a restricted state.

When a customer selects their shipping state (via the entry pop-up or shipping button), CrushSuite checks your configured rules and:

* **Shows products as available** if the customer's state is enabled
* **Hides or marks products as unavailable** if the state is restricted
* **Blocks checkout** if the order violates any state compliance rules

{% hint style="info" %}
**Before You Start:** Have this ready before you begin:

* **Your list of licensed states.** These are the states where you legally hold permits to ship wine. If you're using Vinoshipper, this is already reflected in your Vinoshipper licensing setup, so you can skip this.
* **For self-compliance users:** your permits or licenses for each state, in case you need to reference specific conditions (quantity limits, dry county restrictions, etc.)

If you're not sure which states you're licensed in, pause here and confirm with your compliance counsel before enabling shipping to any state. We enforce the rules you configure, but the responsibility for having correct permits is yours.
{% endhint %}

***

### For Vinoshipper Users

If your Vinoshipper account is connected, your state shipping rules **sync automatically** from your Vinoshipper configuration. CrushSuite pulls the states you're permitted to ship to based on your Vinoshipper licensing setup.

To verify or review your synced rules:

1. Open **CrushSuite** in your Shopify Admin.
2. Navigate to **Compliance** in the sidebar.
3. Review the state shipping rules — each state shows as enabled or disabled based on your Vinoshipper configuration.

If you need to change which states you ship to, **make the change in Vinoshipper first**, then sync in CrushSuite (or wait for the next automatic daily sync).

<figure><img src="/files/0zj3DaHr3kB9BhbQmTTW" alt=""><figcaption></figcaption></figure>

***

### For Self-Compliance Users

If you're managing compliance yourself, you configure state shipping rules directly in CrushSuite:

1. Open **CrushSuite** in your Shopify Admin.
2. Navigate to **Compliance** in the sidebar.
3. Click **State Shipping Rules** (or the equivalent configuration section).
4. For each state, toggle shipping **on** or **off** based on your permits and licensing.
5. Click **Save** to apply your configuration.

{% hint style="warning" %}
**Only enable states where you hold valid permits.** CrushSuite enforces the rules you configure, but it's your responsibility to ensure you have the proper licensing for each state. Consult your compliance counsel if you're unsure about a state's requirements.
{% endhint %}

> 📸 **Screenshot:** State shipping rules configuration with toggle switches for each state — some enabled, some disabled

***

### Understanding the Rules Behind Each State

State DTC shipping laws are complex and vary significantly. For background on what drives these rules — permits, quantity limits, temperature holds, and more — see Understanding State DTC Shipping Laws.

***

### Common Mistakes

**Toggling a state on without valid permits.** CrushSuite will enforce whatever you configure. If you enable a state you're not licensed to ship to, you'll accept orders you can't legally fulfill. Only enable states where your licensing is current.

**Changing states in Shopify instead of Vinoshipper.** For Vinoshipper users, state permissions flow from Vinoshipper to CrushSuite. If you need to add or remove a state, do it in Vinoshipper first. Changes made in CrushSuite can be overwritten on the next sync.

**Expecting changes to appear instantly.** Sync happens automatically, but it can take a few minutes. If you've just made a change in Vinoshipper and don't see it in CrushSuite yet, wait 5 minutes and refresh.

**Not testing after you save.** Always open your store in an incognito browser and test an affected state after making changes. The Go-Live Checklist walks through the full verification.

***

{% hint style="info" %}
Something Not Working?

If a state is enabled but customers in that state are still being blocked, or if a state you disabled is still letting orders through, see: [Customer Compliance Check Failures](/docs/compliance/troubleshooting/customer-compliance-check-failures.md)
{% endhint %}


---

# 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/getting-started/configuring-state-shipping-rules.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.