Listings Overview

What Is a Listing?

A listing is a wine club that your business creates for customers to join. It's the core of your wine club — when someone signs up for your club, they're joining a listing.

Think of a listing as the product you're offering as a club experience. It has a name, description, tagline, images, and all the configuration that determines how billing, fulfillment, and membership work. Each listing can have multiple tiers (different membership levels), so a single listing might offer an "Explorer" tier, a "Connoisseur" tier, and a "Collector" tier all under one umbrella.

You can create as many listings as you need. Some businesses run a single club; others run several for different wine types, price points, or customer segments.

Listing Types

Every listing is one of three types. You choose the type in the first step of the creation wizard ("What type of club are you creating?"), and it cannot be changed once members have joined.

Subscription

Subscription listings bill members on a recurring schedule. You choose the billing frequency when you configure tiers:

Monthly — Charged every month
Every Other Month — Charged every two months
Quarterly — Charged every three months
Semi-Annually — Charged every six months
Annually — Charged once a year

Once a member joins a subscription listing, they're automatically billed on each cycle until they cancel or you pause their membership.

Behind the scenes, the system uses Stripe subscriptions to manage recurring billing. Each cycle produces a fulfillment event where orders are prepared, charged, and shipped.

Release

Release listings don't have a recurring billing schedule. Instead, you create releases whenever you're ready — a new vintage, a seasonal selection, a limited allocation. Members are only billed when a release happens.

This gives you complete flexibility. You might do a release every month, every few months, or whenever you have something special to offer. There's no fixed cadence.

Release members have their own membership statuses: Active, Paused, Cancelled, or Staged. Paused release members retain their seat in the club but are excluded from new releases, receive no rewards, and do not appear in POS loyalty searches.

Membership-Only

Membership-Only listings provide access to rewards and benefits without any wine fulfillment. Members pay a recurring fee (using the same billing frequencies as Subscription clubs) for discounts, event access, and other tier-specific benefits. The fulfillment delivery mode step is hidden during creation since there are no shipments.

Membership-Only listings use the same Stripe subscription billing infrastructure as Subscription listings, but no templates, inventory, or shipping configuration is needed.

Listing Statuses

Every listing has a status that controls its visibility and availability:

Status	Enum Value	What It Means
Draft	`draft`	The listing is being set up and isn't visible to consumers. You can take your time configuring everything before publishing.
Active	`approved`	The listing is live. Members can see it and join.
Archived	`inactive`	The listing has been taken down. It's no longer visible to new members. Existing members may still be managed, but no new signups are accepted.

Draft listings remain invisible to consumers until you publish them, giving you time to finalize all the details. When you're ready, publish the listing to move it to Active status. If you later want to retire a listing, archive it to remove it from public view.

Listing Details

When creating or editing a listing, you'll configure the following information:

Basic Information

Name — The name of your wine club (what members see when browsing)
Description — A detailed description of what the club offers, what members can expect, and why they should join
Tagline — A short, catchy phrase that summarizes your club in a few words (displayed prominently on the listing page)
Category — A display label for the kind of club you're running (e.g., "Wine Club", "Beer Club", etc.)

Images

Each listing has two images:

Hero Image — A large banner image displayed at the top of your listing's public signup page. This is the first thing potential members see, so make it visually appealing.
Thumbnail — A smaller image used when your listing appears in lists, cards, or search results. This helps members quickly identify your club.

Public URL Slug

Every listing gets a unique URL slug that forms part of the public-facing signup page address. For example, if your slug is "sunset-wine-club", your listing page might be accessible at a URL like yoursite.com/clubs/sunset-wine-club. This is the link you can share with potential members or use in marketing materials.

Fulfillment Mode

Subscription listings support two fulfillment modes:

Cycle-Based — Members are grouped into fulfillment cycles and processed together as a batch. This is the standard approach for most subscription clubs.
Individual — Each member's fulfillment is handled independently rather than being batched into cycles.

Delivery Mode

How members receive their orders:

Local Pickup — Members pick up their wine at your tasting room
Shipping — Wine is shipped to the member's address
Both — Members choose between pickup and shipping when they join, and can switch anytime

Tiers

Each listing contains one or more tiers. Tiers are the different membership levels within your club. For example, a single listing might have:

Explorer — Three bottles per shipment at an entry-level price
Connoisseur — Six bottles per shipment at a mid-range price
Collector — A curated premium collection at a higher price

When members join your listing, they choose which tier they want. Each tier defines its own pricing, bottle count, billing frequency, description, and rewards.

Members can be moved between tiers after joining. When a member's tier is changed, the new tier takes effect for the next billing cycle.

Tiers are covered in detail in the Tiers and Pricing guide.

Rewards and Benefits

Each tier within a listing can have its own set of rewards and benefits attached. These are the perks that make membership valuable beyond the wine itself. Rewards can include:

Percentage discounts — e.g., 15% off all wine purchases
Fixed discounts — e.g., $10 off your next order
Text-based benefits — e.g., "Free tasting for 4", "Early access to new releases", "Complimentary shipping on reorders"

Different tiers can offer different rewards, so you can create clear value differences between membership levels.

The Public Listing Page

Every active listing has a public-facing signup page where consumers can learn about your club and join. This page displays the listing name, tagline, description, hero image, available tiers with pricing, and any rewards or benefits. It's the page you share in marketing emails, social media posts, or on your website to drive new signups.

Draft listings do not have a visible public page — consumers cannot see or access a listing until it's published and active.