Skip to content

Troubleshooting

Signup widget not displaying

Symptoms: The wine club signup widget does not appear on your storefront.

Solutions:

  • Ensure at least one club is published. Draft clubs do not appear in the widget. See Managing Clubs for details on publishing.
  • Ensure the Tectalic Wine Club theme block has been added to the page in the Theme Editor (Online Store > Themes > Customize). See Setting Up Your Landing Page for step-by-step instructions.
  • Check that the page is published and accessible to customers.
  • For Curated clubs, verify that all products in each combination are available (in stock, published, and active). Combinations with unavailable products are hidden automatically. See Managing Clubs — Changing Products for more details.

Customer portal not showing

Symptoms: Customers cannot see the Subscriptions section in their account.

Solutions:

  • Ensure the customer portal extension blocks have been added to your customer account pages via the theme editor. See Installation — Enable Customer Portal for setup steps.
  • Tectalic Wine Club requires Shopify's new customer accounts. Legacy customer accounts are not supported. Go to Settings > Customer accounts in your Shopify admin and ensure New customer accounts is selected. Learn more about customer accounts.

See Installation — Verify Store Requirements for the full list of prerequisites and Customer Portal for details on what members can access.

Delivery options missing

Symptoms: The Change Delivery modal only shows standard shipping, even though local delivery or winery pickup is enabled.

Solution: Your fulfillment location needs a complete street address. Shopify requires a full address to calculate local delivery and pickup availability.

  1. Go to Settings > Locations in your Shopify admin
  2. Click on your fulfillment location
  3. Ensure a complete address is configured (street, city, state/province, postal code)
  4. Save the location

See Customer Portal — Change Delivery for more about how delivery options work for members.

Mobile display issues

Symptoms: The signup widget or portal does not display correctly on mobile devices.

Solutions:

  • The app uses responsive design and should adapt to all screen sizes automatically
  • Check for CSS conflicts in your theme that may override the widget's styles
  • Try the widget in a different browser to rule out browser-specific issues

Checkout validation not working

Symptoms: Customers can modify their cart in ways that should be blocked (e.g., removing bottles from a curated case).

Solution: Ensure the checkout validation rule is enabled:

  1. Go to Settings > Checkout in your Shopify admin
  2. Under Checkout rules, verify that the Tectalic Wine Club rule is enabled

See Launching Your Wine Club for the full pre-launch testing checklist.