Listing Form Configuration
Configure what information sellers provide when creating listings. Customize fields, pricing models, calendar modes, and more.
Quick answer
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
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
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.
Multi-session discounts
With multiple date bookings on, a second toggle, "Multi-session discounts", lets sellers charge less per session when a customer books several sessions of one listing together. The seller adds tiers on the listing form, next to the price: for example 2+ sessions at £185 each and 3+ sessions at £175 each, against a regular price of £199. When a customer picks three dates, every one of the three is priced at £175, the calendar shows what they save, and each session still becomes its own booking with the discounted price locked in. Approving or declining one session never changes the price of the others. Tiers are absolute prices, not percentages, and they do not apply to sessions booked with a price option, participant pricing, or pay in person. You only switch the feature on; there is no store-wide default tier, every seller sets their own. On a type that books from the seller's hours (below) the tiers are a percentage off instead, so they work with every session length.
Book from the seller's hours
On a date-time type, "Book from the seller's hours" replaces per-listing time slots with one set of hours per seller. Sellers set their hours, time off and booking rules once on their new Availability page; every price option on a listing carries its own length (30 min, 45 min, 60 min); customers pick an option, a day and a start time; and a booking on one listing blocks that time on all of the seller's listings. Built for lessons, coaching and one-to-one appointments. Keep group classes on a separate slot-based type: their scheduled slots block the seller's hours too. Full details on the Availability page.
City-Only Location Mode
Per Service: 1-on-1 Appointments
The Per Service model works as a clean one-on-one appointment flow for both in-person and online services — coaching, readings, consultations, a chiropractor. Two settings make it fit those bookings:
- Ask the buyer for a service address: a per-type toggle (on by default, shown only for Per Service types). Turn it off for anything that happens online so the booking stops collecting and requiring an address.
- No group framing: per-service bookings drop the “participants” / guest language that only makes sense for group activities, so a single appointment reads as one person, one slot.
60-min coaching session
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.
Session Length (Date + Time Slots)
A time slot is either a start time (“09:00”) or a start and end time (“09:00 - 09:45”). The end time is what tells the buyer, the calendar invite and the booking how long the session is. On Date + Time Slots listings the seller can set a Session length once, at the top of the Availability section of the listing form: it becomes the default appointment duration when they use Fill Day or Quick Fill, and any slot saved without an end time gets that length. Sellers who offer several lengths (30 and 45 minutes, say) should create one listing per length, since price options change the price, not the calendar.
Multi-Session Group Bookings
On Date + Time Slots listings, buyers can select several sessions in one go — a series of training slots, several class dates, a block of appointments — and pay for all of them in a single checkout. As sessions are added, the Reserve card shows the running total and session count, and one confirmation email covers the whole group — for the buyer and for the seller. On the buyer's My Bookings page the sessions are one package card: one status, one total and one Pay button, with each session as a row underneath that keeps its own reschedule, completion and refund. On the seller's Manage Bookings page the sessions sit together under a package banner, each tagged “Session 2 of 4”.
On stores that approve bookings manually, a listing with multi-session discounts (see the Listing Types section above) also sends all selected sessions as one request: the seller gets one email listing every session and answers the package with Approve all or Decline all (a single session can still be declined on its own; the others keep their package price). The customer gets one approval email listing the sessions and pays them all in a single checkout from the package card in My Bookings. A coupon entered with the request is applied to that payment.
Multi-session prices
+ Add tier
You save £72
Each date becomes its own booking at £175. Approving or declining one never reprices the others.
$135.00
3 sessions selected
One payment, one confirmation email, all sessions tracked together in My Bookings.
Fixed Event Dates
Some listings happen on a specific date rather than whenever the buyer picks one — a market booth, a one-off exhibition, a dated experience. Turn on Fixed event date for a listing type and sellers can state the date (or a date range) the listing takes place. It is display-only: there is no buyer date picker and no booking calendar, so the listing still sells through immediate checkout.
Available on Fixed Price and Per Person
Fixed event date
Sellers state when the listing takes place
Event date (on the listing form)
Off by default — existing listings are unaffected until you enable it.
Once set, the event date follows the sale everywhere it matters:
- Shown on the listing card and the detail page
- Snapshotted onto the order at purchase, so it appears on My Orders, My Sales, the receipt, and the order success page
- Included in every order email (request, approved, declined, buyer confirmation, and seller/owner sale)
- Buyers can filter and sort the listings page by event date — this month, the next 30 days, or a custom range
Crystals & Sound Healing Booth
$120.00
The date is display-only and snapshots onto the order, so it travels all the way through to the receipt and emails.
Tags
Tags let sellers label their listings with their own words, such as a brand, a designer or a material. Turn on Enable Tags field in the Tags card on the Listing Form tab. While a seller types a tag, they see suggestions from tags already used on your marketplace, with how many listings use each one, so everyone reuses the same spelling.
Off by default
Tags (on the listing form)
Typing "petiteknit" is saved as "PetiteKnit" when that spelling already exists.
When tags are enabled:
- Sellers press Enter or type a comma to add a tag, and tap the x on a tag to remove it
- Tags keep the seller's capitalization, but matching ignores case, so "PetiteKnit" and "petiteknit" count as the same tag
- Buyers can click a tag on the listing page to see every listing with that tag
- The search on the listings page also finds listings by their tags
- Tags are included in CSV import and export (comma-separated in the
tagscolumn)
Show tags on the listing page
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.
Stock per Option (Sizes, Colours)
By default all options of a listing share one stock number. For goods that come in sizes or colours, sellers can count stock per option instead. There is nothing to switch on in Store Settings: when a listing type has Price Variants on and shows the Stock field, every listing of that type gets a Track stock per option checkbox under Price Options. It is off by default, per listing.
The seller counts each option, the buyer sees what is left
Price Options
name · price · stock
Stock quantity
This is the total of your options.
Cotton lawn remnant
Select an option
Red has 3 left, so the plus button stops at 3. Blue is sold out and cannot be picked.
- With it on, every option needs its own stock number (0 for sold out) and the listing's Stock field becomes the read-only total of its options.
- Buyers pick one option and a quantity of it. Sold-out options are struck through and cannot be picked, each option shows how many are left, and the quantity stops at what the picked option has.
- A sale takes the units off the option that was bought. The listing only shows as sold out in the grid when every option is at 0.
- The cart and checkout check the option, not the listing total, so two buyers cannot both be sold the last Medium.
- "Add to cart" on a listing card opens the listing page instead, because the buyer has to choose an option first.
- Custom offers are not available on a listing that tracks stock per option, because an offer does not name an option.
- Bulk import: put the options in the
variantscolumn, see Import Data.
Listings that do not tick the box are unchanged: their options keep sharing the listing's stock, and buyers can still select several options at once. Not available on calendar (booking) listing types, which do not use stock.
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
Offer Only (No Buy Now)
Agree the price by message, pay a custom offer
Per-type toggle that hides Buy now and Add to cart. The listing price becomes a starting point, the buyer messages the seller, and the seller sends a custom offer in the conversation that the buyer pays through the platform. For made-to-order, commission and quote-based work.
Read the full offer-only guide
Price Rules (Minimum Price, Maximum Order Value, Commission per Type)
Set a price floor and commission rate per listing type, and cap single-order exposure
Minimum listing price stops sellers saving listings where Stripe's fixed fee and your commission eat the whole amount. Maximum order value caps what one seller can take in a single order, with a store default that each seller can override. Pro and up. A per-type commission lets one store take, say, 6% on tack and 12% on lessons.
Read the full price rules 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): Pick from the curated set, or type the name of any of the 1,600+ Lucide icons, to display next to the field on the listing page
- Admin-only field: Only you can edit the value (from Dashboard > Listings). Sellers see it read-only with a lock, which suits fields like a "Verified" status you grant after vetting.
- Hide from sellers: Available once a field is admin-only. Sellers never see the field in their form at all. Use it for internal flags such as "featured on homepage" that you then filter on in a Featured Listings section. The value can still show on the public listing page unless you switch it off under Listing Page settings.
- Copy to another listing type: Custom fields belong to one listing type. This button copies the full setup to another type. Fields that share the same internal name across types can be filtered together on the homepage and the listings 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 ~100 curated icons across 13 categories (Accommodation, Kitchen, Outdoor, Safety, etc.), or search the full Lucide library of 1,600+ icons by name. Any Lucide icon works: find it on lucide.dev and type its name, e.g. "ferris-wheel". The same picker is used for listing type icons.
- 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
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 on new listings. Older listings with fewer images can still be edited, as long as no images are removed
- Maximum Images: Set maximum allowed (up to 50)
- Allow Video: On by default. Turn it off to remove the video upload from the listing form. Videos already added stay on their listings
Buyer & Messaging Settings
- Enable Messaging: Allow buyers to message sellers about listings
- Allow file attachments in messages: Let buyers and sellers attach images, PDF and Word (.docx) files (up to 5 files per message, 10 MB each) to their messages - photos, contracts, invoices, deliverables. Off by default. See File Attachments.
- Require Buyer Account: Require account creation for checkout (enables order history, reviews, messaging)
- Flag prohibited words: When on, add your own words (e.g. payment apps) and any message containing them is flagged for review and the sender is reminded to keep the sale on the marketplace. Messages still send. See Moderation.
Store Settings → Listing Form → Buyer & Messaging Settings
Enable Messaging
Buyers can message sellers about listings
Allow file attachments in messages
Images, PDFs & Word, up to 5 files / 10 MB each
The attachments toggle appears once messaging is enabled. Both parties get a paperclip button in every conversation.
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
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