Listing Form Configuration
Configure what information sellers provide when creating listings. Customize fields, pricing models, calendar modes, and more.
Overview
The Listing Form configuration determines what fields sellers see when creating new listings. You can customize everything from basic fields like title and price, to advanced features like availability calendars, location settings, and custom fields specific to your marketplace type.
How to Access
Go to Store Settings → Listing Form tab to configure your listing form.
What the panel looks like
A simplified view of the layout: pick a listing type at the top, then drag, edit, and toggle the fields each listing type collects.
Simplified illustration. The real panel sits inside Store Settings → Listing Form and includes per-type calendar, pricing, currency, and image settings alongside the field list.
Form Layout: Collapsible Sections
The create-listing and edit-listing forms are organized into collapsible accordion sections — Basic information, Pricing & availability, Photos & gallery, Custom fields, Shipping, and so on. Sellers see one focused chunk of fields at a time instead of a long wall of inputs, which makes it dramatically easier to get an overview when adding or editing a listing. The active section stays open; the rest collapse so the page never feels overwhelming.
The accordion layout applies to both the create-listing flow and the edit-listing form in the seller dashboard. Section dividers you add (under Additional Settings) become accordion sections automatically.
Listing Types
Listing Types allow you to create different categories of listings with unique configurations. For example, a vacation rental marketplace might have "Stays", "Experiences", and "Tours" as separate listing types.
Enable to allow different types of listings with unique fields and settings per type.
Show colored pills on listing cards to identify the listing type (e.g., "Stay", "Experience").
Creating a Listing Type
- Click "Add Type" button
- Enter a Name (e.g., "Vacation Rental")
- The Slug is auto-generated (used in URLs like
/listings?type=vacation-rental) - Add an optional Description
- Configure Card Display to show type as a colored pill on listing cards
Pricing Models
Choose how pricing works for each listing type. Different models suit different marketplace types.
Single fixed price for the item/service. Best for e-commerce products, one-time services, or digital downloads.
Daily, weekly, and monthly pricing options. Ideal for vacation rentals, accommodation, or equipment rentals. Supports additional guest pricing with base occupancy settings.
Total price calculated by multiplying price × number of participants. Perfect for tours, experiences, classes, or group activities. Supports participant types (e.g., Adult, Child, Senior with different prices).
Fixed price with date/time scheduling and service address collection. When a customer books, they select a date and time slot, then provide the address where the service should be performed. Perfect for cleaning services, home repairs, plumbing, tutoring, pet grooming, personal training, or any on-location service marketplace.
Allow Free Listings
Enable "Allow Free Listings" to let sellers create listings with $0 price. Useful for free activities, community events, or promotional offers.
Multiple Date Bookings (Per Service)
When using the Per Service pricing model, enable "Allow Multiple Date Bookings" to let buyers select multiple dates in a single booking request. For example, a customer can book weekly cleaning every Tuesday for a month. Each date becomes a separate booking that the seller can approve individually. The service address is shared across all selected dates.
City-Only Location Mode
When Location is enabled, you can choose between Full Address (street, city, zip with Google autocomplete) or City Only (privacy-friendly — sellers just enter their city). City-only mode is ideal for service marketplaces where the buyer provides their own address during booking, so the seller only needs to indicate which city they serve. Pair this with the "City Area" map type in Product Detail settings to show a wide city-level circle on the map.
Calendar & Availability
Configure how availability and booking dates work for each listing type.
No availability calendar needed. Buyers can purchase immediately. Use for regular products.
Sellers select available date ranges, buyers book check-in to check-out dates. Perfect for vacation rentals, accommodation, or multi-day equipment rentals.
Sellers add specific dates with multiple time slots (e.g., 9:00 AM, 2:00 PM, 6:00 PM). Ideal for tours, experiences, classes, or appointments.
Additional Options Per Listing Type
Capacity Settings
- Max Guests/Participants: Set maximum number of guests or participants
- Additional Guest Pricing: Charge extra for guests beyond base occupancy (for per-night pricing)
- Base Occupancy: Number of guests included in the base price
Participant Types (Per-Person Pricing)
When using per-person pricing, you can define participant types with different prices:
- Adult: Full price
- Child: Reduced price or free
- Senior: Discounted price
- Custom types: Add any participant categories you need
Location Settings
Enable Location
Allow sellers to specify a physical address for their listings. Shows address fields for street, city, state, country, and coordinates. Location can be displayed on a map on the listing page.
Digital Downloads
Enable Digital Files
Allow sellers to upload digital files for download after purchase. Perfect for selling e-books, music, software, templates, or any downloadable content.
File Bundles: Enable to allow sellers to upload multiple files as a bundle.
Price Variants
Enable Price Variants
Allow sellers to add multiple price options per listing. Only available for the Fixed Price pricing model. Perfect for services or rentals with different durations or packages.
Example: A boat charter listing with options like "Half Day Charter — $600", "Full Day Charter — $1,000", "Sunset Cruise — $400". Buyers select an option before checkout, and the selected variant price is used for payment.
Recommended option: Sellers can mark one variant as recommended (shown with a ★ star). The recommended variant is pre-selected for buyers on the listing page.
The listing's base price is automatically set to the lowest variant price when saving.
Variant Add-ons
Per-Variant Add-on Options
Each price variant can have its own set of optional add-ons that buyers configure at booking time. Toggle Has add-ons on a variant to reveal the nested editor. No store-level setting needed — add-ons are available whenever variants are enabled.
Two add-on types:
- Count (integer × unit price) — buyer picks a quantity. Example: "Bathrooms — $15 each" → buyer picks 3, total adds $45.
- Yes/No (flat price) — single checkbox. Example: "Fridge cleaning — $30" → buyer ticks it once, total adds $30.
Why nest add-ons under variants? Each variant is essentially a different service with its own relevant add-ons. A "House cleaning" variant wants "Bathrooms × $15", while a "Window cleaning" variant wants "Number of windows × $5". Nesting hides irrelevant add-ons.
Multi-variant bookings: Buyers can pick more than one variant in a single booking (the variant selector renders as checkboxes, not radio buttons). Each picked variant can carry its own add-ons. The combined total updates live as the buyer toggles selections.
Optional base price: A variant's base price can be left blank (defaults to $0) so the variant can be entirely add-on driven (e.g. "Window cleaning, $5 per window").
Server-side pricing: The server always recomputes booking totals from the selected variants and add-ons against the live listing — clients never determine the final price.
Add-ons
Lead Time & Buffer Time
Booking Time Settings
- Lead Time: Minimum advance booking notice (e.g., 24 hours before)
- Buffer Time: Required gap between bookings (e.g., 24 hours between guests)
iCal Calendar Sync
Sync with Airbnb, VRBO & Booking.com
Two-way calendar sync prevents double bookings when sellers list the same property on multiple platforms. Available on the Per Night pricing model.
Read the full iCal sync guide
Pay in Person (Cash at Session)
Skip online payment, settle in cash at the appointment
Per-listing toggle that bypasses Stripe checkout. Bookings are still created and tracked in the dashboard, but the buyer pays the seller directly when they arrive. Useful for service marketplaces (training, lessons, consultations) where sellers prefer cash and don't want online-payment friction.
Read the full pay-in-person guide
Custom Fields
Add custom fields to collect specific information from sellers. Custom fields can be unique to each listing type.
Field Types
Single line text input
Multi-line text for longer content
Numeric input with min/max
Dropdown with predefined options
Choose multiple options
Yes/No boolean field
Date picker
Time selection
Address with coordinates
Quantity selector with options
Field Configuration Options
- Internal Name: Used in the database (no spaces)
- Label: Display name shown to sellers
- Placeholder: Hint text inside the field
- Help Text: Additional instructions below the field
- Required: Make the field mandatory
- Display Width: Full, half, or third width
- Icon (optional): Choose an icon from a curated set of ~95 icons to display next to the field on the listing page
Icons
Add icons to your custom fields to make listing pages more visual and easier to scan. Icons are shown on the listing detail page next to the field label.
- Field Icon: A single icon for the field label (e.g., a bed icon next to "Bedrooms"). Shown on the listing detail page.
- Option Icons: For Select and Multi-Select fields, you can set a different icon for each option value (e.g., WiFi icon for "WiFi", pool icon for "Pool"). Great for amenity lists.
- Searchable Picker: Browse ~95 curated icons across 13 categories (Accommodation, Kitchen, Outdoor, Safety, etc.) or search by name.
- Checkbox + Icon: For checkbox fields with an icon, only the icon and label are shown — "Yes" is hidden since the presence of the item already means yes.
- On Listing Cards: When a field has an icon and is set to "Show on Card", the icon is shown on listing cards instead of the pill/text style.
Example: Amenity Icons
Create a Multi-Select custom field called "Amenities" with options like WiFi, Pool, Hot Tub, Air Conditioning, etc. Then set an icon for each option — guests will see a clean icon + text list on the listing page, similar to Airbnb.
Card Display Settings
Show custom field values on listing cards in the All Listings page:
- Show on Card: Enable to display this field on listing cards
- Display Style: Show as a colored pill/badge or plain text
- Pill Color: Choose the background color for pill display
- Limit: Maximum 5 custom fields can be shown on cards
Section Dividers
Add section dividers to organize your form into logical groups. Click "Add Section"to insert a divider with an optional title.
Drag & Drop Reordering
Reorder Fields
Drag fields using the grip handle to reorder them. Both default fields and custom fields can be reordered together to create your ideal form layout.
Additional Settings
Currency Settings
- Default Currency: USD, EUR, GBP, CAD, AUD, JPY
- Decimal Pricing: Allow cents (e.g., $9.99) or whole numbers only
Image Settings
- Require Images: Make images mandatory for all listings
- Minimum Images: Set minimum number of images required
- Maximum Images: Set maximum allowed (up to 50)
Buyer & Messaging Settings
- Enable Messaging: Allow buyers to message sellers about listings
- Require Buyer Account: Require account creation for checkout (enables order history, reviews, messaging)
Internal Tracking
- Unique Identifier: Allow sellers to add internal reference fields (e.g., SKU, source URL). Private to sellers only.
Form Preview
Live Preview Panel
On desktop, a live preview panel shows how your form will look to sellers in real-time. On mobile, switch between "Configure" and "Preview" tabs to see your changes.
Best Practices
- • Keep required fields to a minimum to reduce friction for sellers
- • Use section dividers to group related fields
- • Add help text to explain complex fields
- • Test your form by creating a listing yourself
- • Changes auto-save after 1 second of inactivity