Wine Selections & Releases

This guide covers how to make your wine selections when your club uses Customer Choice — meaning you get to pick which wines you'd like! It also covers viewing and selecting wines for Release Club drops.

Customer Choice Selection (Subscription Clubs)

When a new cycle opens and your club uses Customer Choice, you'll receive a notification (email) with a link to your selection page. You can also get there from the app:

Click My Clubs in the sidebar.
Click on the membership card for the club with a pending selection.
On the Membership Detail page, look in the Fulfillment History section for the current cycle.
Click the link or button to open your selection page.

What You'll See on the Selection Page

The selection page has the title "Make Your Selection" at the top left. Here's the full layout:

Header area (top of page):

Page title: "Make Your Selection"
Below the title: a link to the business name and a link to your club name (e.g., "View My Club")
Subtitle text: "Your wine club has pre-selected [N] items for you. You can adjust quantities or add more items below."

Countdown timer badge (top-right corner):

A yellow badge with a clock icon showing the time remaining (e.g., "6d 23h 12m")
Hover over it to see the tooltip: "If you don't make a selection by the deadline, your pre-selected items will be automatically confirmed."

Minimum selection banner (if applicable):

A blue banner appears below the header if your club requires a minimum number of bottles.
Text: "Minimum Selection Required" — "You must select at least [N] bottles for this club."

Search bar:

A search field with a magnifying glass icon and placeholder text "Search wines by name..."
Type to filter the wine list in real time.
A Clear button (X icon) appears when you've typed something.

Wine cards:

Pre-selected items appear first, highlighted with a green border.
Each wine card shows:
- Wine image (or a wine glass icon placeholder)
- Wine name
- Price per item (with strikethrough original price if discounted)
- "per item" label
- Quantity controls: a − button, the current quantity number, and a + button
If a wine has limited stock, hitting the maximum shows a red error: "Maximum [N] available"
Pre-selected items start with the winery's suggested quantity already set.
Additional available wines appear below the pre-selected items with the same card format.

Sticky footer (bottom of screen):

The footer stays fixed at the bottom of the screen as you scroll.
Left side: Shows pricing info:
- If your selection total exceeds your subscription price, it shows "Estimated Additional: $XX.XX" with an overage breakdown
- If no overage, the footer is centered on the button
Right side / Center: The confirmation button:
- Before selecting any items: "Select" (disabled)
- After selecting items: "Confirm [N] items" (e.g., "Confirm 6 items")
- If minimum not met: button is disabled
- While submitting: "Submitting..." with a spinner

How to Make Your Selection

Review the pre-selected wines (green-bordered cards at the top). Adjust quantities using the + and − buttons.
Scroll down to browse additional available wines. Add any you'd like with the + button.
Use the search bar to find a specific wine by name.
Watch the sticky footer at the bottom — it updates in real time with your selection count and any additional charges.
When you're happy with your selection, tap "Confirm [N] items" in the sticky footer.
A success message appears: "Your wine selection has been confirmed and payment processed!"

After Confirming Your Selection

Once confirmed, the page changes to a confirmation view showing:

A green checkmark icon with the heading "Selection Confirmed!"
A subtitle: "Your selection has been finalized for this cycle."
A card titled "Your Selected Items" listing each wine with its quantity.
A "What's Next?" card with status-appropriate messages:
- "Your selection has been confirmed and payment has been processed"
- "The business will prepare your order and contact you when it's ready"
- "You'll receive a notification when your items are ready for [pickup/shipping]"
If there was an overage charge: a "Premium selections charge" box with the overage, any fees, and total charged.
A Payment Summary section with subtotal, tax, fees, and total.
Shipping or pickup information (depending on your fulfillment method).
A Back to Club button at the bottom.

Payment Failed During Selection

If your payment fails when you confirm:

If you're still within the selection deadline, an amber warning banner appears: "Payment Failed - You Can Still Adjust Your Selection". You can adjust your selections to reduce the overage, or click Update Payment Method to fix your card.
If the deadline has passed, you'll see a red screen: "Payment Failed — There was an issue processing your payment. The selection window has now passed. Please contact the winery to discuss your order." with a Back to Club button.

Release Selection (Release Clubs)

Release Clubs work similarly but are tied to specific wine releases rather than recurring cycles:

Click My Clubs in the sidebar.
Click on your Release Club membership card.
On the Membership Detail page, look for the release with a "Select" or "Make Your Selection" button in the release history.
Click it to open the release selection page.

Release Detail Page

Between the membership and the selection screen, each release also has its own release detail page at /member/memberships/[id]/releases/[releaseId]. You can reach it by clicking the release name (rather than "Make Your Selection") in your release history. The detail page shows:

The release name, description, and key dates (open, selection cutoff, charge date)
Your current reservation status (Pending Choice, Confirmed, Charged, Ready, Fulfilled, etc.)
Your selected items as an order-style breakdown with prices, taxes, and fees
A Skip This Release button if skips are still allowed and you have skips remaining
A Make Your Selection / Edit Selection button if the selection window is still open
A Retry Payment button if the charge for this release failed (more on this below)

Release Selection Page Layout

The layout is similar to the subscription Customer Choice page with these differences:

The title is "Make Your Selection" with a back arrow linking to the release detail page.
A countdown timer badge appears in the top-right if there's a deadline.
The footer shows "Estimated Pre-Tax / Fees Total: $XX.XX" instead of an overage, since release clubs charge per bottle (no recurring subscription price).
The confirmation button reads "Confirm [N] items" just like the subscription version.

After Confirming a Release Selection

The confirmation view shows "Selection Confirmed!" with:

Your selected items and quantities
The estimated total
A Payment Summary section
Shipping or pickup information
A Back to Club button

Release Payment Retry

If the charge for a release fails (expired card, insufficient funds, etc.), you'll receive a "Payment Failed" email with a retry link. Clicking it brings you to the Release Payment Retry page (/member/memberships/[id]/release-payment-retry?releaseId=[releaseId]):

An order-style breakdown of the items the winery picked or you selected
Your saved payment methods on file with a default selected
A note explaining whether the failure is recoverable (most card declines are; fraud blocks are not)
A Retry Payment button

You can also reach this page from your Payments dashboard or the release detail page if a retry is needed. After a successful retry, you're redirected back to the release detail page and the release proceeds to fulfillment normally.

Locked Items (Exact Set)

Some clubs don't offer Customer Choice — the winery chooses your wines for you. In this case:

Your selection page shows a summary view with the heading "Order Confirmed!" or "Items" listing the wines and quantities chosen for you.
No + / − buttons appear since the selection is fixed.
The page displays the same status progression as Customer Choice (Confirmed → Ready for Pickup/Shipping → Fulfilled).

Selection Status Progression

After you confirm your selection, the status moves through these stages:

Status	What It Means	What You See
Pending Choice	Waiting for you to select wines	Selection page with wine cards
Confirmed	Selection locked in, payment processed	Green checkmark, "Selection Confirmed!"
Ready for Pickup	Your order is packed and waiting	"Ready for Pickup!" with pickup info
Ready for Shipping	Your order is being prepared to ship	"Ready for Shipping!"
Fulfilled	Shipped or picked up	"Order Complete!"
Payment Failed	Payment issue	Warning banner or error screen

Tips

Don't wait until the last minute! The countdown timer shows exactly how long you have. If the deadline passes without a selection, your pre-selected items are automatically confirmed.
Watch your total. If you pick more expensive wines or add more bottles, the overage amount shows in the sticky footer so there are no surprises.
Search is your friend. Use the search bar to quickly find a specific wine rather than scrolling through the full list.