# CrushSuite

## Home

- [CrushSuite Knowledge Center](https://crushsuite.gitbook.io/docs/knowledgecenter.md): Help docs for CrushSuite, the wine commerce suite for Shopify.

## Compliance

- [Welcome to CrushSuite Compliance](https://crushsuite.gitbook.io/docs/compliance/readme.md)
- [Installation & First Login](https://crushsuite.gitbook.io/docs/compliance/getting-started/installation-and-first-login.md)
- [Connecting Your Vinoshipper Account](https://crushsuite.gitbook.io/docs/compliance/getting-started/connecting-your-vinoshipper-account.md)
- [Granting CrushSuite Access to Your Vinoshipper Account](https://crushsuite.gitbook.io/docs/compliance/getting-started/granting-crushsuite-access-to-your-vinoshipper-account.md)
- [Self-Compliance Setup (Without Vinoshipper)](https://crushsuite.gitbook.io/docs/compliance/getting-started/self-compliance-setup-without-vinoshipper.md)
- [Configuring State Shipping Rules](https://crushsuite.gitbook.io/docs/compliance/getting-started/configuring-state-shipping-rules.md)
- [Understanding State DTC Shipping Laws](https://crushsuite.gitbook.io/docs/compliance/getting-started/understanding-state-dtc-shipping-laws.md): Why state shipping rules matter, and which of them CrushSuite checks for you versus your compliance provider.
- [Setting Up State Alcohol Fees](https://crushsuite.gitbook.io/docs/compliance/getting-started/setting-up-state-alcohol-fees.md)
- [Configuring Your Shipping Profile](https://crushsuite.gitbook.io/docs/compliance/getting-started/configuring-your-shipping-profile.md): Your shipping profile connects CrushSuite to Shopify's shipping system so that checkout reflects accurate, real-time shipping rates from your carrier (typically through Vinoshipper). This step is esse
- [Setting Up Shopify Sales Tax](https://crushsuite.gitbook.io/docs/compliance/getting-started/setting-up-shopify-sales-tax.md): CrushSuite handles alcohol-specific compliance fees, but standard sales tax collection is managed through Shopify's built-in tax system. You need to configure Shopify to collect sales tax in every sta
- [Setting Up Pre-Checkout Requirements](https://crushsuite.gitbook.io/docs/compliance/getting-started/setting-up-pre-checkout-requirements.md): Pre-checkout requirements ensure that every customer is verified for age and address before they can complete a wine purchase. CrushSuite enforces these checks automatically — your job is to make sure
- [Setting Up Your App Embeds](https://crushsuite.gitbook.io/docs/compliance/getting-started/setting-up-your-app-embeds.md): App embeds are how CrushSuite's compliance features appear on your storefront. They control the age verification modal, the shipping state selector, product-level compliance badges, and collection-lev
- [Go-Live Checklist](https://crushsuite.gitbook.io/docs/compliance/getting-started/go-live-checklist.md): You've finished setup. Now check everything is configured correctly before your store takes live orders: run through this checklist, then place a test order to confirm the whole flow works.
- [How Product Sync Works](https://crushsuite.gitbook.io/docs/compliance/managing-products/how-product-sync-works.md): Product sync keeps your wine catalog consistent across Vinoshipper, CrushSuite, and Shopify. This page explains how the sync pipeline works, what data moves where, and how to trigger a manual sync.
- [Mapping Product Compliance Data](https://crushsuite.gitbook.io/docs/compliance/managing-products/mapping-product-compliance-data.md): Every wine product in your store needs compliance data — ABV, bottle volume, varietal, and vintage — so CrushSuite can enforce state-specific shipping rules and calculate alcohol fees correctly.
- [Setting Product Availability by State](https://crushsuite.gitbook.io/docs/compliance/managing-products/setting-product-availability-by-state.md): 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
- [Alcohol vs. Non-Alcohol Products](https://crushsuite.gitbook.io/docs/compliance/managing-products/alcohol-vs.-non-alcohol-products.md): Your Shopify store can sell wine alongside merchandise, accessories, gift cards, and other non-alcohol items. CrushSuite distinguishes between these product types so that compliance rules only apply w
- [Merging Products & Creating Variants](https://crushsuite.gitbook.io/docs/compliance/managing-products/merging-products-and-creating-variants.md): If you sell the same wine across multiple vintages or bottle sizes, you can merge them into a single Shopify product with variants. This creates a cleaner shopping experience — customers see one produ
- [Removing or Archiving Products](https://crushsuite.gitbook.io/docs/compliance/managing-products/removing-or-archiving-products.md): When you need to take a product off your Shopify store, the correct workflow depends on whether you use Vinoshipper or manage compliance yourself. Getting this right prevents sync issues and keeps you
- [How Pre-Checkout Compliance Works](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/how-pre-checkout-compliance-works.md): What your customers go through from landing on your store to Shopify checkout, and what CrushSuite checks along the way.
- [Age Verification — What Your Customers See](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/age-verification-what-your-customers-see.md): Federal and state laws require that wine purchasers be at least 21 years old. CrushSuite enforces age verification at the point of entry to your store, ensuring customers confirm their age before brow
- [Address Validation — What Your Customers See](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/address-validation-what-your-customers-see.md): What CrushSuite checks about a customer's shipping address, what it leaves to your compliance provider, and the messages customers see.
- [The Compliance Gate Experience — Visual Walkthrough](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/the-compliance-gate-experience-visual-walkthrough.md): This page is a step-by-step visual walkthrough of what your customers see from landing on your store to completing a purchase. Use it to understand the experience from your customer's perspective and
- [Main CrushSuite App Embed (Required)](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/main-crushsuite-app-embed-required.md): The Main CrushSuite App embed is the core of CrushSuite's storefront functionality. It powers the compliance engine, the shipping state selector button, and enables all other embeds to work. This embe
- [Entry Pop-Up Modal Embed](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/entry-pop-up-modal-embed.md): The Entry Pop-Up Modal is the first thing customers see when they visit your store. It handles age verification and shipping state selection — two critical compliance steps — in a single, branded expe
- [Product Page Compliance Details Embed](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/product-page-compliance-details-embed.md): This embed controls how compliance information appears on your individual product pages. It tells customers whether a specific wine can ship to their state and gives them visibility into where you can
- [Collection Page Compliance Settings Embed](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/collection-page-compliance-settings-embed.md)
- [Configuring a Featured Collection with Compliance](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/configuring-a-featured-collection-with-compliance.md): Featured collections are the product showcases on your homepage — "Best Sellers," "New Releases," "Staff Picks," and similar highlights. By default, featured collections use Shopify's built-in collect
- [Customizing the Compliance UI](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/customizing-the-compliance-ui.md): CrushSuite's storefront compliance elements are designed to integrate seamlessly with your existing Shopify theme. Every customer-facing element can be customized to match your winery's branding. This
- [Removing Accelerated Checkout Buttons (Shop Pay, Google Pay, and More)](https://crushsuite.gitbook.io/docs/compliance/storefront-and-checkout/removing-accelerated-checkout-buttons-shop-pay-google-pay-and-more.md)
- [How Order Sync Works](https://crushsuite.gitbook.io/docs/compliance/orders-and-fulfillment/how-order-sync-works.md): What happens to an order after checkout: what CrushSuite sends to Vinoshipper, what comes back, and which orders are never sent.
- [Order Lifecycle](https://crushsuite.gitbook.io/docs/compliance/orders-and-fulfillment/order-lifecycle.md): The statuses an order can have in CrushSuite, what each one means, and what to do when an order gets stuck.
- [Compliance Fees on Orders](https://crushsuite.gitbook.io/docs/compliance/orders-and-fulfillment/compliance-fees-on-orders.md): How the state alcohol fee is worked out, how it shows on the order, and where it's recorded in Shopify, CrushSuite and your compliance provider.
- [Handling Failed or Blocked Orders](https://crushsuite.gitbook.io/docs/compliance/orders-and-fulfillment/handling-failed-or-blocked-orders.md): What to do when an order doesn't reach Vinoshipper or fails its compliance check: how to find it, what each status means, and which button to use.
- [Fulfillment with Vinoshipper](https://crushsuite.gitbook.io/docs/compliance/orders-and-fulfillment/fulfillment-with-vinoshipper.md): What happens after an order reaches Vinoshipper: how it gets fulfilled, when Shopify is updated, and when you need to step in.
- [Creating Draft Orders](https://crushsuite.gitbook.io/docs/compliance/orders-and-fulfillment/creating-draft-orders.md): Draft orders let you create orders yourself for phone sales, in-person pickups and other sales outside your online checkout. Here's how to set them up so they reach Vinoshipper correctly.
- [UPS Access Point Pickup](https://crushsuite.gitbook.io/docs/compliance/orders-and-fulfillment/ups-access-point-pickup.md): UPS Access Point pickup lets your customers have their wine shipped to a nearby UPS location instead of their home. Available for Vinoshipper stores using live shipping rates.
- [How the State Compliance Engine Works](https://crushsuite.gitbook.io/docs/compliance/state-compliance-reference/how-the-state-compliance-engine-works.md): What CrushSuite checks before checkout, what your compliance provider checks, and what can still come up after an order is placed.
- [Quantity Limits (Per-Shipment and Monthly)](https://crushsuite.gitbook.io/docs/compliance/state-compliance-reference/quantity-limits-per-shipment-and-monthly.md): How state limits on wine quantity are enforced, and which limits CrushSuite checks itself.
- [Pausing Shipping for Heat or Weather](https://crushsuite.gitbook.io/docs/compliance/state-compliance-reference/temperature-hold-requirements.md): How to pause shipping to a state, or warn customers about delays, during extreme heat or other weather.
- [Dry County Restrictions](https://crushsuite.gitbook.io/docs/compliance/state-compliance-reference/dry-county-restrictions.md): Some counties ban alcohol delivery even in states that allow wine shipping. Here is who checks for them, and what that means for you.
- [Temporarily Disabling a State](https://crushsuite.gitbook.io/docs/compliance/state-compliance-reference/temporarily-disabling-a-state.md): If you need to stop shipping to a state temporarily — whether due to a licensing issue, regulatory change, or business decision — you can disable the state without removing your configuration.
- [Vinoshipper Connection Issues](https://crushsuite.gitbook.io/docs/compliance/troubleshooting/vinoshipper-connection-issues.md): If CrushSuite can't connect to your Vinoshipper account — or if a previously working connection stops functioning — use this guide to diagnose and resolve the issue.
- [Product Sync Errors](https://crushsuite.gitbook.io/docs/compliance/troubleshooting/product-sync-errors.md): Product sync errors occur when CrushSuite can't successfully pull product data from Vinoshipper or push it to Shopify.
- [Order Sync Failures](https://crushsuite.gitbook.io/docs/compliance/troubleshooting/order-sync-failures.md): What to check when an order placed in Shopify doesn't reach Vinoshipper, and how to fix it.
- [Customer Compliance Check Failures](https://crushsuite.gitbook.io/docs/compliance/troubleshooting/customer-compliance-check-failures.md): If customers say they can't get through the compliance form, use this guide to find out why and what to change.
- [Tax Calculation Issues](https://crushsuite.gitbook.io/docs/compliance/troubleshooting/tax-calculation-issues.md): If customers are being charged incorrect taxes — or if taxes aren't showing up at checkout — this guide helps you identify and fix the problem.
- [App Embed Not Displaying](https://crushsuite.gitbook.io/docs/compliance/troubleshooting/app-embed-not-displaying.md)
- [Checkout Button Skips the Compliance Form](https://crushsuite.gitbook.io/docs/compliance/troubleshooting/checkout-button-skips-the-compliance-form.md): A customer reached Shopify checkout without seeing the compliance form. Usually a custom or mini-cart checkout button the app can't recognize, and a one-line theme fix.
- [Common Error Messages Reference](https://crushsuite.gitbook.io/docs/compliance/troubleshooting/common-error-messages-reference.md): The messages your customers and you can see from CrushSuite, what causes each one, and what to do.
- [General FAQs](https://crushsuite.gitbook.io/docs/compliance/faqs/general-faqs.md)
- [Orders & Checkout FAQs](https://crushsuite.gitbook.io/docs/compliance/faqs/orders-and-checkout-faqs.md)
- [Product FAQs](https://crushsuite.gitbook.io/docs/compliance/faqs/product-faqs.md)
- [Vinoshipper FAQs](https://crushsuite.gitbook.io/docs/compliance/faqs/vinoshipper-faqs.md)

## Clubs

- [Welcome to CrushSuite Clubs](https://crushsuite.gitbook.io/docs/clubs/readme.md): CrushSuite Clubs turns your Shopify store into a recurring wine club platform — scheduled release shipments, member self-service, and batched billing, without Shopify Plus.
- [Installation & First Login](https://crushsuite.gitbook.io/docs/clubs/getting-started/installation-and-first-login.md): Install CrushSuite Clubs and get your winery to a working nav bar — the one step every store completes before any club setup begins. Takes about 5 minutes, plus choosing a plan.
- [Creating Your First Club](https://crushsuite.gitbook.io/docs/clubs/getting-started/creating-your-first-club.md): Create the club, and get the Shopify membership product and selling plan that come with it. Takes about 10 minutes.
- [Setting Up Your Club Product Template](https://crushsuite.gitbook.io/docs/clubs/getting-started/setting-up-your-club-product-template.md): Build a dedicated club product template, add the signup widget to it, and assign it to your club product. Takes about 10 minutes.
- [Setting Up Your Club Product Page](https://crushsuite.gitbook.io/docs/clubs/getting-started/setting-up-your-club-product-page.md): The Club Membership Signup Widget's settings — its text, the optional "How it works" popup, and signup cutoff behavior. Takes about 8 minutes.
- [Setting Up the Member Portal](https://crushsuite.gitbook.io/docs/clubs/getting-started/setting-up-the-member-portal.md): Add the Clubs page to your customer accounts menu so members can manage their club. This takes about 5 minutes.
- [Setting Up Email Branding & Notifications](https://crushsuite.gitbook.io/docs/clubs/getting-started/setting-up-email-branding-and-notifications.md)
- [Go-Live Checklist](https://crushsuite.gitbook.io/docs/clubs/getting-started/go-live-checklist.md)
- [How Releases Work](https://crushsuite.gitbook.io/docs/clubs/managing-releases/how-releases-work.md): A release is a scheduled shipment of its own products, dates and price rules. The pipeline behind one, and the statuses and phases you'll see.
- [Understanding Release Dates](https://crushsuite.gitbook.io/docs/clubs/managing-releases/understanding-release-dates.md): Every release runs on five dates, and getting their order wrong is the most common source of confusion in Clubs. What each date does, the rules enforced, and a worked example.
- [Creating a Release](https://crushsuite.gitbook.io/docs/clubs/managing-releases/creating-a-release.md): This article walks the release form section by section, using the exact fields you'll see. It takes about 10 minutes once your products are in Shopify.
- [Managing Release Orders](https://crushsuite.gitbook.io/docs/clubs/managing-releases/managing-release-orders.md): Once a release is published, CrushSuite builds one release order per member and tracks it through billing. This article covers where those orders live, what each status means, and what you can do befo
- [Inventory & Allocation](https://crushsuite.gitbook.io/docs/clubs/managing-releases/inventory-and-allocation.md): CrushSuite reserves inventory for a release ahead of billing so stock isn't oversold in the gap between allocation and shipping.
- [How Customers Join Your Club](https://crushsuite.gitbook.io/docs/clubs/managing-members/how-customers-join-your-club.md): A customer can become a member through five paths — storefront checkout, two admin paths, POS, and CSV migration. What each one needs, what it creates, and what the member gets.
- [Adding Members Manually](https://crushsuite.gitbook.io/docs/clubs/managing-members/adding-members-manually.md): Use this when a customer wants to join over the phone, at a tasting, or by email.
- [What Members Can Do Themselves](https://crushsuite.gitbook.io/docs/clubs/managing-members/what-members-can-do-themselves.md): Most of what a member needs day to day they can do themselves, from the member portal inside Shopify's Customer Accounts. Which requests to expect, and which ones genuinely need you.
- [Membership Billing & Payment Retries](https://crushsuite.gitbook.io/docs/clubs/managing-members/membership-billing-and-payment-retries.md): If your club charges a membership fee, that fee bills on its own schedule — completely separate from any release orders the same member gets billed for.
- [Migrating Payment Methods from Vinoshipper](https://crushsuite.gitbook.io/docs/clubs/migrating-from-another-platform/migrating-payment-methods-from-vinoshipper.md): Move your members' saved cards from Vinoshipper to your store so migrated members are billed without re-entering payment. Works on every Shopify plan.
- [Preparing Your Member CSV](https://crushsuite.gitbook.io/docs/clubs/migrating-from-another-platform/preparing-your-member-csv.md): CrushSuite validates your CSV column by column before anything is imported. This reference lists every column, whether it's required, and the rules each value has to pass.
- [Club Settings Reference](https://crushsuite.gitbook.io/docs/clubs/reference/club-settings-reference.md): Every setting on a club's creation form and its Settings page, with its default, valid range, and whether changing it later reaches existing members and orders.
- [App Embed Settings Reference](https://crushsuite.gitbook.io/docs/clubs/reference/app-embed-settings-reference.md): Every setting on CrushSuite Clubs two theme extension pieces, plus the one setting on the order-status banner extension.
- [Clubs & CrushSuite Compliance](https://crushsuite.gitbook.io/docs/clubs/reference/clubs-and-crushsuite-compliance.md): Clubs and Compliance are separate apps that work together. What the Compliance Fees setting actually does, how the fee is worked out, and what a failed check does.
- [App Embed Not Displaying](https://crushsuite.gitbook.io/docs/clubs/troubleshooting/app-embed-not-displaying.md): The signup widget renders blank, doesn't appear at all, or shows the wrong product on your club product page. Work through these causes to find which one applies.
- [Members Can't See Their Club](https://crushsuite.gitbook.io/docs/clubs/troubleshooting/members-cant-see-their-club.md): A member says the Clubs page is missing from their account, or their club isn't listed in it. Diagnose which cause applies and how to fix it.
- [General FAQs](https://crushsuite.gitbook.io/docs/clubs/faqs/general-faqs.md): Short answers to the questions wineries ask most often about running a club on CrushSuite — billing, members, releases, migration, and archiving.

## Developer Docs

- [Developer Docs](https://crushsuite.gitbook.io/docs/developers/readme.md)

## Changelog

- [Changelog](https://crushsuite.gitbook.io/docs/changelog/readme.md): New updates and improvements across the CrushSuite apps.