{"version":1,"pages":[{"id":"JsKd452Nu8XTrHz68zaF","title":"CrushSuite Knowledge Center","pathname":"/docs","siteSpaceId":"sitesp_V9Rzr","description":"Welcome to your team’s developer platform","breadcrumbs":[{"label":"Home","icon":"house"}]},{"id":"LThc2RqOxBKU56Qt3TMy","title":"Welcome to CrushSuite Compliance","pathname":"/docs/compliance","siteSpaceId":"sitesp_gPxKi","icon":"hand-wave","description":"","breadcrumbs":[{"label":"Compliance","icon":"grapes"}]},{"id":"24WeIgBwj8ucuKyvanSi","title":"Installation & First Login","pathname":"/docs/compliance/getting-started/installation-and-first-login","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"bJUEEx9T22OfCjfZsNse","title":"Connecting Your Vinoshipper Account","pathname":"/docs/compliance/getting-started/connecting-your-vinoshipper-account","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"AhwfWLTmKDMopC71Tr1r","title":"Granting CrushSuite Access to Your Vinoshipper Account","pathname":"/docs/compliance/getting-started/granting-crushsuite-access-to-your-vinoshipper-account","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"HmVFCpjkzLlGsDPKObOc","title":"Self-Compliance Setup (Without Vinoshipper)","pathname":"/docs/compliance/getting-started/self-compliance-setup-without-vinoshipper","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"HKE3pBeJW9F0uiRuF7wm","title":"Configuring State Shipping Rules","pathname":"/docs/compliance/getting-started/configuring-state-shipping-rules","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"owuGiXYyR0O8kY5hv1kL","title":"Understanding State DTC Shipping Laws","pathname":"/docs/compliance/getting-started/understanding-state-dtc-shipping-laws","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"MOqNNdruGXgnTNEwQ8lv","title":"Setting Up State Alcohol Fees","pathname":"/docs/compliance/getting-started/setting-up-state-alcohol-fees","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"hfgOKhLBXZoAj3Uh4Ush","title":"Configuring Your Shipping Profile","pathname":"/docs/compliance/getting-started/configuring-your-shipping-profile","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"KN9UrC3TCt0TmdIcnGkt","title":"Setting Up Shopify Sales Tax","pathname":"/docs/compliance/getting-started/setting-up-shopify-sales-tax","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"auueSwjqUpNIp1KsPvCZ","title":"Setting Up Pre-Checkout Requirements","pathname":"/docs/compliance/getting-started/setting-up-pre-checkout-requirements","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"P5TbseF0qW4PTLSH9Vcm","title":"Setting Up Your App Embeds","pathname":"/docs/compliance/getting-started/setting-up-your-app-embeds","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"xLVegoygDtgnOjyK5mNt","title":"Go-Live Checklist","pathname":"/docs/compliance/getting-started/go-live-checklist","siteSpaceId":"sitesp_gPxKi","description":"You've completed the setup steps — now let's verify everything is configured correctly before your store starts accepting live orders. Run through this checklist and then place a test order to confirm","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Getting Started"}]},{"id":"hFexLU29Okc20uIIOdp9","title":"How Product Sync Works","pathname":"/docs/compliance/managing-products/how-product-sync-works","siteSpaceId":"sitesp_gPxKi","description":"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.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Managing Products"}]},{"id":"FahoUlr6fDAIDftZVTsz","title":"Mapping Product Compliance Data","pathname":"/docs/compliance/managing-products/mapping-product-compliance-data","siteSpaceId":"sitesp_gPxKi","description":"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.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Managing Products"}]},{"id":"VB2l9dY4QCTi6JmGj2wr","title":"Setting Product Availability by State","pathname":"/docs/compliance/managing-products/setting-product-availability-by-state","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Managing Products"}]},{"id":"2PiXdPrVNejWuu3dVSh3","title":"Alcohol vs. Non-Alcohol Products","pathname":"/docs/compliance/managing-products/alcohol-vs.-non-alcohol-products","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Managing Products"}]},{"id":"Jve7wXvYddRHOPm5secm","title":"Merging Products & Creating Variants","pathname":"/docs/compliance/managing-products/merging-products-and-creating-variants","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Managing Products"}]},{"id":"hCwjNLg5qZaiorF9i73E","title":"Removing or Archiving Products","pathname":"/docs/compliance/managing-products/removing-or-archiving-products","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Managing Products"}]},{"id":"woRs97rceuvZ4PaMMxgY","title":"How Pre-Checkout Compliance Works","pathname":"/docs/compliance/storefront-and-checkout/how-pre-checkout-compliance-works","siteSpaceId":"sitesp_gPxKi","description":"CrushSuite adds a compliance layer before Shopify's standard checkout. This ensures every wine order meets state legal requirements before payment is processed. Here's what happens behind the scenes a","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"yb4YxAJ9JOhJ7t61gPLG","title":"Age Verification — What Your Customers See","pathname":"/docs/compliance/storefront-and-checkout/age-verification-what-your-customers-see","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"5uZSQp4aU4iE7yFdyzs8","title":"Address Validation — What Your Customers See","pathname":"/docs/compliance/storefront-and-checkout/address-validation-what-your-customers-see","siteSpaceId":"sitesp_gPxKi","description":"CrushSuite validates customer shipping addresses before checkout to ensure the destination is eligible for wine delivery. This prevents orders from being placed to addresses where wine can't legally o","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"5Cz4X8iXcFZtDWaKRFV3","title":"The Compliance Gate Experience — Visual Walkthrough","pathname":"/docs/compliance/storefront-and-checkout/the-compliance-gate-experience-visual-walkthrough","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"39qCkll6lBPMH2BMCx3I","title":"Main CrushSuite App Embed (Required)","pathname":"/docs/compliance/storefront-and-checkout/main-crushsuite-app-embed-required","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"wmHwZ6qhjjd9qfCE2cpC","title":"Entry Pop-Up Modal Embed","pathname":"/docs/compliance/storefront-and-checkout/entry-pop-up-modal-embed","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"9SODMfTSDfEs2QHKZAKZ","title":"Product Page Compliance Details Embed","pathname":"/docs/compliance/storefront-and-checkout/product-page-compliance-details-embed","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"qizxvhJZLtR9xX9gZEoG","title":"Collection Page Compliance Settings Embed","pathname":"/docs/compliance/storefront-and-checkout/collection-page-compliance-settings-embed","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"UUwvREpunEq9HVwrKpVL","title":"Configuring a Featured Collection with Compliance","pathname":"/docs/compliance/storefront-and-checkout/configuring-a-featured-collection-with-compliance","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"gO6z4tnix1aYvx85s9K8","title":"Customizing the Compliance UI","pathname":"/docs/compliance/storefront-and-checkout/customizing-the-compliance-ui","siteSpaceId":"sitesp_gPxKi","description":"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","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Storefront & Checkout"}]},{"id":"JlLQo2lNg8joZSPUlVLN","title":"How Order Sync Works","pathname":"/docs/compliance/orders-and-fulfillment/how-order-sync-works","siteSpaceId":"sitesp_gPxKi","description":"When a customer completes a purchase on your Shopify store, CrushSuite syncs the order to Vinoshipper in real time. This page explains the sync pipeline and what data transfers.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Orders & Fulfillment"}]},{"id":"EsSlnTkl1IlYt0kcCm3E","title":"Order Lifecycle","pathname":"/docs/compliance/orders-and-fulfillment/order-lifecycle","siteSpaceId":"sitesp_gPxKi","description":"Every order moves through a series of statuses from the moment a customer clicks \"Pay\" to when the package arrives at their door. Understanding this lifecycle helps you monitor your operations and cat","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Orders & Fulfillment"}]},{"id":"EQYflNpYiGrVTkeblCJk","title":"Compliance Fees on Orders","pathname":"/docs/compliance/orders-and-fulfillment/compliance-fees-on-orders","siteSpaceId":"sitesp_gPxKi","description":"Every order that includes alcohol products may have compliance fees applied. This page explains how those fees are calculated, how they appear on orders, and how they're recorded.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Orders & Fulfillment"}]},{"id":"sSxAokP38wgAbe45zQFM","title":"Handling Failed or Blocked Orders","pathname":"/docs/compliance/orders-and-fulfillment/handling-failed-or-blocked-orders","siteSpaceId":"sitesp_gPxKi","description":"Sometimes an order fails to sync or gets blocked during compliance processing. This page covers the most common failure scenarios and how to resolve each one.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Orders & Fulfillment"}]},{"id":"cJH7exNc7H3YR0sL8yMv","title":"Fulfillment with Vinoshipper","pathname":"/docs/compliance/orders-and-fulfillment/fulfillment-with-vinoshipper","siteSpaceId":"sitesp_gPxKi","description":"Once an order syncs to Vinoshipper, fulfillment is managed through Vinoshipper's warehouse and shipping infrastructure. This page explains what happens after the order leaves CrushSuite.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Orders & Fulfillment"}]},{"id":"L8rJWTgncgfR6Ncv7mKh","title":"Creating Draft Orders","pathname":"/docs/compliance/orders-and-fulfillment/creating-draft-orders","siteSpaceId":"sitesp_gPxKi","description":"Draft orders let you manually create orders for phone sales, in-person pickups, or other situations where the customer isn't going through your standard online checkout. CrushSuite supports draft orde","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Orders & Fulfillment"}]},{"id":"Ha7ndCtgiIXCGqKeCC8i","title":"UPS Access Point Pickup","pathname":"/docs/compliance/orders-and-fulfillment/ups-access-point-pickup","siteSpaceId":"sitesp_gPxKi","description":"CrushSuite supports UPS Access Point pickup, which lets your customers have their orders shipped to a nearby UPS Store location instead of their home address.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Orders & Fulfillment"}]},{"id":"zkMb1E9r2vEuih1uZEyb","title":"How the State Compliance Engine Works","pathname":"/docs/compliance/state-compliance-reference/how-the-state-compliance-engine-works","siteSpaceId":"sitesp_gPxKi","description":"The state compliance engine is the system that evaluates every order against state-level DTC shipping laws in real time. It's the backbone of CrushSuite's compliance enforcement.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"State Compliance Reference"}]},{"id":"hxSYWzgb3diVhkRUXtW2","title":"Quantity Limits (Per-Shipment and Annual)","pathname":"/docs/compliance/state-compliance-reference/quantity-limits-per-shipment-and-annual","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"State Compliance Reference"}]},{"id":"K7Gjhh1HfdANfuryuaNV","title":"Temperature Hold Requirements","pathname":"/docs/compliance/state-compliance-reference/temperature-hold-requirements","siteSpaceId":"sitesp_gPxKi","description":"Some states restrict or prohibit alcohol shipment during periods of extreme heat to prevent spoilage. These temperature holds temporarily block shipping to affected states during hot months.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"State Compliance Reference"}]},{"id":"NgdDJbvAU8pwj3nWZl0K","title":"Dry County Restrictions","pathname":"/docs/compliance/state-compliance-reference/dry-county-restrictions","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"State Compliance Reference"}]},{"id":"gItegw2vG6UOxi5qLS2M","title":"Temporarily Disabling a State","pathname":"/docs/compliance/state-compliance-reference/temporarily-disabling-a-state","siteSpaceId":"sitesp_gPxKi","description":"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.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"State Compliance Reference"}]},{"id":"Jyklk2jLxbSScOcvVgZt","title":"Vinoshipper Connection Issues","pathname":"/docs/compliance/troubleshooting/vinoshipper-connection-issues","siteSpaceId":"sitesp_gPxKi","description":"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.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Troubleshooting","icon":"6"}]},{"id":"XHv7gnUfuBQa0B7Dbepj","title":"Product Sync Errors","pathname":"/docs/compliance/troubleshooting/product-sync-errors","siteSpaceId":"sitesp_gPxKi","description":"Product sync errors occur when CrushSuite can't successfully pull product data from Vinoshipper or push it to Shopify.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Troubleshooting","icon":"6"}]},{"id":"Lji9BLSKlOFp3wZ73L1h","title":"Order Sync Failures","pathname":"/docs/compliance/troubleshooting/order-sync-failures","siteSpaceId":"sitesp_gPxKi","description":"Order sync failures occur when an order placed in Shopify doesn't successfully transfer to Vinoshipper.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Troubleshooting","icon":"6"}]},{"id":"eXUPSnlsZ7fA65Wgd1op","title":"Customer Compliance Check Failures","pathname":"/docs/compliance/troubleshooting/customer-compliance-check-failures","siteSpaceId":"sitesp_gPxKi","description":"If customers report that they can't complete a purchase — or if you see a high rate of compliance check failures in your dashboard — use this guide to diagnose the issue.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Troubleshooting","icon":"6"}]},{"id":"vz8vuXWOYaFRkQ1rObCn","title":"Tax Calculation Issues","pathname":"/docs/compliance/troubleshooting/tax-calculation-issues","siteSpaceId":"sitesp_gPxKi","description":"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.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Troubleshooting","icon":"6"}]},{"id":"Ko271iPuJjWWXxRxjh71","title":"App Embed Not Displaying","pathname":"/docs/compliance/troubleshooting/app-embed-not-displaying","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Troubleshooting","icon":"6"}]},{"id":"LJ7KnSMl2g5bNI2VPOFI","title":"Common Error Messages Reference","pathname":"/docs/compliance/troubleshooting/common-error-messages-reference","siteSpaceId":"sitesp_gPxKi","description":"A quick-reference guide to error messages you may encounter in CrushSuite, what they mean, and what to do.","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"Troubleshooting","icon":"6"}]},{"id":"kXiGmF6ceLlNeKujohXd","title":"General FAQs","pathname":"/docs/compliance/faqs/general-faqs","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"FAQs","icon":"7"}]},{"id":"FlsBR0cmBExgxZicoGs3","title":"Orders & Checkout FAQs","pathname":"/docs/compliance/faqs/orders-and-checkout-faqs","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"FAQs","icon":"7"}]},{"id":"BFzeYYIBsvjTP4Qre3VX","title":"Product FAQs","pathname":"/docs/compliance/faqs/product-faqs","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"FAQs","icon":"7"}]},{"id":"EGck33F2DjjmBlESAaVb","title":"Vinoshipper FAQs","pathname":"/docs/compliance/faqs/vinoshipper-faqs","siteSpaceId":"sitesp_gPxKi","breadcrumbs":[{"label":"Compliance","icon":"grapes"},{"label":"FAQs","icon":"7"}]},{"id":"trLwwmumlaofzMKwR3fr","title":"Welcome to Clubs","pathname":"/docs/clubs","siteSpaceId":"sitesp_zRjlq","icon":"bottle-droplet","description":"CrushSuite Clubs is wine club management built natively on Shopify. Run winery-curated release clubs, customer-built subscription boxes, or both — with batched billing, member customization windows, a","breadcrumbs":[{"label":"Clubs","icon":"wine-glass"}]},{"id":"trLwwmumlaofzMKwR3fr","title":"Developers Docs","pathname":"/docs/developers","siteSpaceId":"sitesp_vzlCe","icon":"terminal","description":"","breadcrumbs":[{"label":"Developer Docs","icon":"brackets-curly"}]},{"id":"xSKACgaFjsHdWkvrL7EZ","title":"Changelog","pathname":"/docs/changelog","siteSpaceId":"sitesp_ljMom","icon":"clock-rotate-left","description":"New updates and improvements made to the compliance app.","breadcrumbs":[{"label":"Changelog","icon":"clock-rotate-left"}]}]}