Setting Product Availability by State
CrushSuite automatically controls which products customers can see and purchase based on their shipping state. This page explains how the product availability engine works and what your customers expe
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:
Is this state enabled? — Based on your state shipping rules, is the customer's state one you can legally ship to?
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.
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.
Last updated