Welcome to CrushSuite Compliance
CrushSuite Compliance connects your wine compliance infrastructure with Shopify's checkout natively. Your customers never leave your Shopify store, and you can legally sell and ship wine direct-to-consumer without needing Shopify Plus.
This section of the knowledge base will get you from app install to first successful order. Most wineries complete the full setup in about an hour.
Your Setup Path
Setup happens in three phases. Plan for 45 to 75 minutes end to end, depending on how much of your Vinoshipper and licensing setup is already in place.
Phase 1 — Before You Start (about 5 minutes)
Get CrushSuite installed and connect it to the system that holds your compliance data.
Installation & First Login — install from the Shopify App Store, approve permissions, log in
Then choose one:
Connecting Your Vinoshipper Account — if you use Vinoshipper
Self-Compliance Setup (Without Vinoshipper) — if you manage compliance yourself
You'll know Phase 1 is complete when CrushSuite shows either a "Connected" status for Vinoshipper or a successful self-compliance configuration.
Phase 2 — Configure (about 30 to 45 minutes)
The bulk of the setup work. These steps configure CrushSuite for your specific winery, your licensed states, and your Shopify theme.
Do these in order. Each step builds on the one before it.
Configuring State Shipping Rules — which states you can ship to
Setting Up State Alcohol Fees — per-state fees that appear at checkout
Configuring Your Shipping Profile — real-time carrier rates
Setting Up Shopify Sales Tax — tax collection for each selling state
Setting Up Pre-Checkout Requirements — age verification and address validation
Setting Up Your App Embeds — the compliance UI on your storefront
Reference material (optional, read when you need it):
Understanding State DTC Shipping Laws — background on the regulatory landscape if you're new to DTC
Phase 3 — Verify You're Live (about 10 to 15 minutes)
Confirm everything works before you drive real traffic.
This is the most important step in the entire setup. We've seen clients pass every in-app check, feel confident they're done, and then discover a problem on their first real customer order. The Go-Live Checklist covers a full test order end to end, including verifying the order syncs to Vinoshipper.
Don't skip it.
Using Vinoshipper or Going Self-Compliance?
Most clients use CrushSuite with Vinoshipper. Vinoshipper handles state licensing, regulatory filings, and fulfillment coordination, and CrushSuite connects that to your Shopify checkout.
If you manage your own compliance and licensing without Vinoshipper, CrushSuite also supports that path. You'll enter your compliance data directly in the app.
→ Self-Compliance Setup (Without Vinoshipper)
Quick Links by Role
Winery owner setting up for the first time: Start with Phase 1 above.
Agency or developer setting up on behalf of a client: Same path. Just make sure you have the client's Vinoshipper API keys and Shopify admin access before you begin.
Existing client coming back for a specific task: Jump directly to the section you need.
Something Not Working?
If a step in this guide isn't behaving the way it describes, check Troubleshooting first. The most common setup issues are covered there with specific fixes:
If you're still stuck, we're here to help. Reach out at crushsuite.com/contact and we'll jump in.
Last updated