# Setting Product Availability by State

***

### How Product Availability Works

When a customer visits your store and selects their shipping state (through the entry pop-up or shipping button), CrushSuite checks two things:

1. **Is this state enabled?** — Based on your state shipping rules, is the customer's state one you can legally ship to?
2. **Is this specific product available in this state?** — Even within enabled states, certain products may be restricted based on ABV, volume, or other state-specific rules.

If both checks pass, the product displays normally. If either check fails, the product is marked as unavailable.

***

### What Customers See

#### Product is available

The product page and collection listing display normally. The customer can add the product to their cart and proceed to checkout.

#### Product is NOT available

Depending on your app embed configuration, customers see one or more of the following:

* A **"Cannot purchase" message** on the product page (customizable text, e.g., "This wine cannot be shipped to your state")
* A **compliance indicator badge** on collection pages showing the product is unavailable

The customer is never left guessing — they see a clear explanation of why the product isn't available and can update their shipping state to check availability elsewhere.

<figure><img src="/files/mcUuHTET8suxsW8i816X" alt=""><figcaption></figcaption></figure>

***

### Availability Updates in Real Time

Product availability isn't static. When a customer changes their shipping state — by clicking the shipping button, using the entry pop-up, or updating their address — CrushSuite rechecks availability instantly. Products appear and disappear in real time without a page reload.

This means a customer in California might see your full catalog, while a customer who switches to a restricted state sees certain products disappear immediately.

***

### For Vinoshipper Users

Product availability rules sync from your Vinoshipper configuration. Vinoshipper determines which products can ship to which states based on your licensing and state regulations. CrushSuite enforces these rules on your Shopify storefront.

If you need to change product availability for a specific state, update the configuration in Vinoshipper and sync.

***

### For Self-Compliance Users

You control product availability through your state shipping rules in CrushSuite. When you enable or disable a state in Configuring State Shipping Rules, it affects all wine products for that state.

***

### Customizing the Availability Experience

You can customize how unavailable products appear to customers through the app embed settings:

* **Cannot purchase message text** — what the customer reads when a product is restricted
* **Indicator colors and size** — badge appearance on collection pages
* **Indicator position** — where the badge appears on product thumbnails

See the Storefront & Checkout section for detailed customization guides.


---

# 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/managing-products/setting-product-availability-by-state.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.