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 Bookings Calendar Links

With shareable booking calendar page links, you can:

  • Create a link to a Wix site's booking calendar page with preset values you choose.
  • Create a link for rescheduling a specific existing booking.

Introduction

When a site visitor navigates to make a booking on a Wix site, they are taken to a booking calendar page. Here, they select their preferences for the date and time of their booking. Depending on the site's settings, they may also be able to select a time zone, and filter by location and staff member.

When the booking calendar page opens, the calendar typically appears with a default date, time, and time zone based on the site's settings. No location or staff member filters are selected.

With query parameters, you can create and share a direct link to a booking calendar page with customized pre-filled default values of your choice. A site visitor who visits the page via your custom link can still change their selections, but the values you define appear as default choices.

Using query parameters, you can select default values for these fields:

  • Date
  • Time zone
  • Resources (staff members)
  • Locations

In addition, you can provide a Booking ID to create a link for rescheduling a specific existing booking.

Creating your shareable link

To create your customized shareable link, follow these steps:

  1. Obtain the Wix site's booking calendar page URL.
  2. Determine which query parameters you want to use.
  3. Find the values you need for the query parameters. For a resource or location, or to reschedule an existing booking, read more about finding IDs.

Booking calendar page URL

The booking calendar page is the page where a site visitor selects details for an appointment or class and requests a booking. You can add query parameters at the end of the URL for this page.

You can find the full URL for a Wix site's booking calendar page by navigating to the page in a browser and looking in the address bar.

Alternatively, you can construct the full URL for a booking calendar page on the basis of the site URL and the slug for the service. The full URL for a booking calendar page is structured as follows:

Copy

To find the service slug using the site dashboard, follow these steps:

  1. Log into the site's dashboard.
  2. Click "Booking Services" in the sidebar menu.
  3. Hover over the desired service in the list of services to make the "Edit" button appear, then click the "Edit" button. This opens the page for managing the service.
  4. Scroll down to the "Marketing & SEO" section on the right, then click "Edit SEO Settings". This opens the "SEO Settings" section.
  5. The service slug appears in the "URL slug" section.

For example, if a Wix site's URL is www.my-example-site.com and the service slug is initial-consultation, the URL will be:

Copy

Query parameters

Attach any of the following query parameters to a booking calendar page URL to preset customized default settings of your choice:

Query ParameterDescription
resourceOne or more resources (staff members) to be selected by default, identified by ID. Use commas to separate multiple resource IDs.
timezoneDefault time zone for the booking calendar, in tz database format. For example: America/Santiago. Note: You can only select a time zone the page supports as an option. For more information, see Setting the Time Zone Display.
dateInitial date to open in the booking calendar page, in YYYY-MM-DD format.
locationOne or more business locations, identified by ID. Use commas to separate multiple location IDs.
bookingIdID of an existing booking to reschedule. Note: The site member who booked the original session needs to be logged in.

Finding IDs

To set customized default resources (like a staff member) or locations, or to reschedule an existing booking, you need to obtain the relevant IDs. You can do this as follows:

Resources

To find the ID for a resource using the site dashboard, follow these steps:

  1. Log into the site's dashboard.
  2. Click "Booking Calendar" in the sidebar menu, then click "Staff" in the submenu that opens.
  3. Hover over the desired resource in the list of resources to make the "Edit" button appear, then click on the "Edit" button. This opens the page for editing the resource's details.
  4. Once you are on the resource's page, you can find their ID in the page URL in the address bar of the browser, after /bookings/staff/details/

For example, in the following URL, the resource ID is 76570209-101f-409b-af97-b445bdb63125:

Copy

Locations

To find the ID for a business location, call listLocations() or queryLocations().

Existing bookings

To find an existing booking ID, call queryExtendedBookings().

Examples

The following are examples of shareable links for a site's booking calendar page with query parameters set to customized default values.

Preset date:

Copy

Preset date and time zone:

Copy

Preset resource and location:

Copy

Multiple preset resources and locations:

Copy

Booking ID to reschedule an existing booking, with preset date and locations:

Copy
Did this help?