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.
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).
Allow Free Listings
Enable "Allow Free Listings" to let sellers create listings with $0 price. Useful for free activities, community events, or promotional offers.
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.
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)
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
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 3 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