Installation¶

This guide covers the one-time technical setup to get the Tectalic Wine Club app running on your Shopify store.

1. Verify Store Requirements¶

Before installing, confirm your store meets these requirements:

Payment gateway: Your store needs an active payment gateway that supports Shopify subscriptions (e.g., Shopify Payments, Stripe, or another compatible provider).

New Customer Accounts: Your store must use Shopify's new customer accounts (not the classic/legacy version). Tectalic Wine Club does not support legacy customer accounts. Learn more about customer accounts.

To check: Go to Settings > Customer accounts in your Shopify admin and ensure New customer accounts is selected.

2. Install the App¶

Install the Tectalic Wine Club app from the Shopify App Store. After installation, the app appears in your Shopify admin under Apps.

Your store starts on the free Startup 10 plan, which includes up to 10 wine club subscriptions with full feature access. When you're ready to grow beyond 10 subscriptions, you can upgrade to a paid plan from Settings > Billing in the app.

3. Enable Customer Portal¶

The customer portal lets members manage their subscriptions from their account page. To enable it, add the Tectalic Wine Club extension blocks to your customer account pages via the theme editor.

1. In your Shopify admin, go to Online Store > Themes > Customize
2. From the page dropdown at the top, select Checkout and customer accounts
3. From the page dropdown at the top, select Customer Accounts > Orders
4. Click the Apps tab on the left, locate the Tectalic Wine Club app, click the + next to View Subscription Button, then click Add page to > Orders and Order status
5. Click the Apps tab on the left again, locate the Tectalic Wine Club app, click the + next to My Subscriptions, then click Add page to > Accounts
6. Click Save (top right)
7. Click the Add to menu button to add the My Subscriptions page to your customer account menu
8. Click Save to save the menu, then close the menu settings by clicking X (top right)
9. Exit the editor by clicking the back button at the top left of the screen

Once enabled, customers can view and manage their subscriptions from the My Account section, and will see a View Subscription button on their orders:

See Customer Portal for details on what members can view and manage from their account.

4. Enable Checkout Validation¶

Checkout validation ensures wine club orders meet your case size and product requirements.

1. In your Shopify admin, go to Settings > Checkout
2. Under Checkout rules, enable the Tectalic Wine Club validation rule

This prevents customers from modifying their cart in ways that would break wine club requirements (e.g., removing bottles from a curated case).