# 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](managing-clubs.md) 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](landing-page.md) 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](managing-clubs.md#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](installation.md#3-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](https://help.shopify.com/en/manual/customers/customer-accounts/upgrade).

See [Installation — Verify Store Requirements](installation.md#1-verify-store-requirements) for the full list of prerequisites and [Customer Portal](customer-portal.md) 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](customer-portal.md#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](setup.md#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](launching.md#1-test-the-complete-flow) for the full pre-launch testing checklist.