Go Headless

/

Log In
Velo
Articles
API Overview
Getting Started
Tutorials
Velo Package Readmes
Release Notes

Velo-Only APIs
About Velo-Only APIs and the SDK
$w
$widget
wix-animations-frontend
wix-configs-backend
wix-http-functions
wix-realtime-backend
wix-application
wix-editor
wix-widget

APIs
About Velo APIs and the SDK
wix-activity-counters.v2
wix-analytics.v2
wix-auth
wix-billing.v2
wix-billing-backend
wix-blog-backend
wix-bookings-frontend
Introduction
Bookings Schema for Wix Search
Sample Flow
Shareable Booking Calendar Links
Shareable Booking Form Links
Shareable Bookings Service Page Links
checkoutBooking()
getCheckoutOptions()
getServiceAvailability()
wix-bookings.v1
wix-bookings.v2
wix-bookings-backend
wix-business-tools.v2
wix-cache-backend
wix-captcha.v2
wix-captcha-backend
wix-chat-backend
wix-comments.v2
wix-crm-frontend
wix-crm.v2
wix-crm-backend
wix-dashboard
wix-dashboard-management.v2
wix-data
wix-data.v2
wix-ecom.v2
wix-ecom-frontend
wix-ecom-backend
wix-email-marketing.v2
wix-events-frontend
wix-events.v2
wix-events-backend
wix-fetch
wix-forms.v2
wix-forum.v2
wix-forum-backend
wix-groups.v2
wix-groups-backend
wix-inbox.v2
wix-location-frontend
wix-loyalty.v2
wix-marketing-backend
wix-marketing.v2
wix-marketing-tags.v2
wix-media-backend
wix-media.v2
wix-members-frontend
wix-members.v2
wix-members-backend
wix-mobile
wix-multilingual.v2
wix-navigate-mobile
wix-pay-frontend
wix-pay-backend
wix-payment-provider-backend
wix-pricing-plans-frontend
wix-pricing-plans.v2
wix-pricing-plans-backend
wix-pro-gallery-backend
wix-realtime-frontend
wix-reviews.v2
wix-restaurants.v2
wix-search
wix-secrets-backend
wix-secrets-backend.v2
wix-seo-frontend
wix-site-frontend
wix-site-backend
wix-storage-frontend
wix-storage-mobile
wix-stores.v2
wix-stores-frontend
wix-stores-backend
wix-table-reservations.v2
wix-tags.v1
wix-urls.v2
wix-web-module
wix-window-frontend
wix-site-plugins.v1

Events & Service Plugins
About Events & Service Plugins and the SDK
Activity Counters
Automations
Billing
Bookings
Business Tools
Comments
CRM
Data
eCommerce
Email Marketing
Forms
Forum
Groups
Inbox
Loyalty
Marketing
Marketing Tags
Media
Members
Pricing Plans
Payments
Pro-Gallery
Routers
Site Monitoring
Stores
Table Reservations
Wix Events
Log In




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
    https://<SITE_URL>/booking-form
  2. Choose the preloaded settings and add the relevant query parameters to the URL. The final URL should follow this pattern:
    Copy
    https://<SITE_URL>/booking-form?<PARAMETER1>=<VALUE1>&<PARAMETER2>=<VALUE_2>
  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
https://www.bookings-site.com/booking-form?bookings_sessionId=y38a2405-0c8d-4ab9-9542-a440395c1747&bookings_timezone=Ireland/Dublin

Preloading the course and time zone:

Copy
https://www.bookings-site.com/booking-form?bookings_serviceId=38a2405-0c8d-4ab9-9542-a440395c1747&bookings_timezone=Australia/Sidney

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

Copy
https://www.bookings-site.com/booking-form?bookings_serviceId=38a2205-0c8d-5ad9-8877-a440395c1747&bookings_resourceId=76570209-101f-409b-af97-b445bdb63125&bookings_startDate=2023-02-20T10:00:00.000&bookings_endDate=2023-02-20T11:00:00.000&bookings_timezone=Brazil/East
Did this help?