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).
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.
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 & More
Only available for the Per Night pricing model. When enabled, sellers can sync their listing availability with external platforms like Airbnb, VRBO, and Booking.com using the iCal standard.
How it works:
- Export Calendar: Each listing gets a unique iCal URL. Sellers copy this URL and paste it into Airbnb/VRBO under "Import Calendar". When someone books on your marketplace, those dates are shared with the external platform.
- Import Calendar: Sellers paste their Airbnb/VRBO calendar export URL into the listing settings. Your marketplace fetches this feed every 2 hours and blocks those dates automatically.
Both directions are needed for full sync. Since iCal sync has up to a 2-hour delay, we recommend using manual booking approval (not instant booking) to prevent double bookings during the sync window.
Setting Up iCal Sync
- Enable "iCal Calendar Sync" in the listing type settings (Listing Form tab)
- Sellers will see a new "Calendar Sync" section when editing their listings
- They copy the Export URL and paste it into Airbnb/VRBO
- They copy their Airbnb/VRBO calendar URL and paste it into the Import field
- Availability syncs automatically every 2 hours
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