Go Headless

Changelog

SDK
Articles
Get Started
Work with the SDK
Set up a Client
Use the Wix MCP

Core Modules
About Core Modules
sdk
essentials
web-methods

Host Modules
About Host Modules
dashboard
editor
site

Business Solutions
About Business Solutions
ai-site-chat
blog
bookings
cache
crm
data
ecom
events
restaurants
stores
realtime

Frontend Modules
About Frontend Modules
bookings
Introduction
Setup
Sample Flow
Shareable Booking Calendar Links
Shareable Booking Form Links
Shareable Bookings Service Page Links
checkoutBooking()
getCheckoutOptions()
getServiceAvailability()
crm
ecom
events
location
members
mobile
navigate-mobile
pay
pricing-plans
seo
site
storage
stores
window
site-realtime

Shareable Booking Form Links

The booking form is one of several Bookings pages that is automatically added to a site when Wix Bookings is installed. It is the last page in the booking process. You can customize each Bookings page to best suit the business and brand.

You can customize the booking form by preloading default values. This simplifies customer experience when they book a service and allows them to skip preceding Bookings pages. To do so, specify preloaded default values as query parameters in the booking form page URL and direct customers to it. Customers can still change the selected values.

For example, if you are sending out invitations by email as part of promoting a class, you can add a shareable link in the email that already contains the event ID, date, and time. Once the recipient clicks the link, they just have to enter their own personal details without having to also enter event details.

Customizable default values

You can set default values for these parameters:

Query ParameterDescription
bookings_resourceIdResource ID. Required for appointments.
bookings_timezoneTime zone in tz database format. Always required. For example: America/Santiago. Note: You can only select a time zone the Wix site supports as an option. For more information, see Setting the Time Zone Display.
bookings_startDateInitial date to open in the Booking Form page, in YYYY-MM-DDTHH:mm:ss.SSS format. Required for appointments.
bookings_endDateEnd date for the Booking Form Page, in YYYY-MM-DDTHH:mm:ss.SSS format. Required for appointments.
bookings_locationIdID of the business location.
bookings_sessionIdSession ID. Required for classes. You can use Query Availability to retrieve available appointments and class sessions.
bookings_serviceIdService ID. Required for courses and appointments.

Required parameters

Classes, courses, and appointment-based services require a different set of minimum parameters when constructing the URL, since the final URL must cover all the information a customer would have had to specify if they were progressing manually through the Bookings pages. These are the minimum required parameters:

  • Classes: bookings_sessionId and bookings_timezone.
  • Courses: bookings_serviceId and bookings_timezone.
  • Appointments: bookings_serviceId, bookings_resourceId, bookings_startDate, bookings_endDate and bookings_timezone.

Send a shareable booking form link

To send a preloaded, shareable booking form link:

  1. Visit the relevant booking form page in the live site and save the <SITE_URL>. The URL follows this pattern:
    Copy
  2. Choose the preloaded settings and add the relevant query parameters to the URL. The final URL should follow this pattern:
    Copy
  3. Share the generated link with customers. You can send the link through various channels including email, chat, or text.

Sample links

These are shareable booking form sample links with preloaded default values.

Preloading the class session and time zone:

Copy

Preloading the course and time zone:

Copy

Preloading the appointment with resource, start date, end date, and time zone:

Copy
Did this help?