Help Center/Merchant Console & Marketplace/Make a listing bookable: booking fields in the product builder
Merchant Console & Marketplace•Last updated: 2026-10-20•3 min read

Make a listing bookable: booking fields in the product builder

In the Pricing and Booking section choose the booking status, the booking amount from the approved tiers, the slot capacity and the launch window. The server validates them and the storefront and booking engine read them.

Have questions or need step-by-step guidance on this topic?

Ask AI Copilot

Step-by-Step Procedure

1

Create the listing first

In the listing studio or the advanced builder save the product. A new product is created with POST and then edited, so the booking fields are saved on the second step.

2

Open Pricing and Booking

In the advanced builder open "04. Pricing & Tiers". Set the full price in USD, then under "Slot booking" set "Booking status", "Booking amount (USD)" (only approved tiers are offered), "Slot capacity" (empty means no limit is published) and "Launch window".

3

Save

Save. The server refuses an amount that is not an approved tier or is not below the full price, a negative capacity or an unknown status, and says why. Only administrators can save booking fields. Every change is recorded in the audit trail.

4

Check the storefront

A listing appears on /marketplace only when it is active and has booking fields. Leave all four empty to keep it unbookable.

Expected Operational Outcome

The listing is bookable with the amount, capacity and launch window you chose.

Troubleshooting & Failure Modes

Symptom: The save says booking fields cannot be stored yet
Likely Cause: The database section 926 has not been applied.
Resolution: Ask the platform owner to run npm run db:apply:product-booking-fields.

Was this guide helpful?

Help us refine our platform documentation

Related Ecosystem Documentation