Go Headless

/

SDK
Articles
Get Started
Work with the SDK
Set up a Client
Use the Wix MCP
What's New

Core Modules
About Core Modules
sdk
sdk-react (deprecated)
essentials
web-methods

Host Modules
About Host Modules
dashboard
dashboard-react (deprecated)
editor
site

Backend Modules
About Backend Modules
activity-counters
analytics
async-jobs
ai-site-chat
app-management
auth-management
automations
benefit-programs
billing
blog
bookings
business-tools
cache
calendar
captcha
categories
comments
consent-policy
crm
dashboard-management
data
data-extension-schemas
ecom
email-marketing
email-subscriptions
embeds
events
forms
forum
get-paid
groups
http-functions
identity
inbox
loyalty
marketing
marketing-consent
marketing-tags
media
members
moderation-rules
multilingual
notifications
payments
portfolio
pricing-plans
pro-gallery
redirects
reports
restaurants
reviews
search
secrets
stores
tags
urls
site-plugins
sender-details
sender-emails
realtime

Account Level Modules
About Account Level APIs
b2b-site-management
domains
resellers
user-management
sites

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?