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 club are available (in stock, published, and active). Clubs 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.
• Shopify has retired the old customer accounts system. Tectalic Wine Club requires the new customer accounts to work. Go to Settings > Customer accounts in your Shopify admin to upgrade. Learn more about upgrading.

See Installation — Verify Store Requirements for the full list of prerequisites and Customer Portal for details on what customers 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 customers.

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

Purchase type option missing from a discount¶

Symptoms: When creating a Shopify automatic discount, the Purchase type selector (Subscription / One-time purchase) doesn't appear.

Solution: Shopify hides the Purchase type selector until you have a published club. Publish a club, then create the discount. See Setup — Free shipping for subscribers for the steps.

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.

Subscription charging an old card after a Shop Pay update¶

Symptoms: A customer changed their card details in the Shop app, but their subscription still charges the old card — or their payment keeps failing.

Shop Pay cards are managed by the customer in the Shop app or at shop.app. What happens next depends on how they changed their details:

• Edited the existing card (for example a new expiry date) — the update applies to their subscription automatically. Nothing further is needed.
• Added a new card — existing subscriptions stay on the old card. Ask the customer to open their subscription in the customer portal and select the new card under Update payment method.

If the customer's payment is failing and they can't resolve it in Shop Pay, send them a secure update link from the subscription page — see Update payment method.