With booking calendar page query parameters, you can:
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:
In addition, you can provide a Booking ID to create a link for rescheduling a specific existing booking.
To create your customized shareable link, follow these steps:
The booking calendar page is the page where a Wix site visitor selects details for an appointment or class and requests a booking. Query parameters are added 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:
1
To find the service slug using the site dashboard, follow these steps:
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:
1
Attach any of the following query parameters to a Wix site booking calendar page URL to preset customized default settings of your choice:
Query Parameter | Description |
---|---|
resource | One or more resources (staff members) to be selected by default, identified by ID. Use commas to separate multiple resource IDs. |
timezone | Default 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. |
date | Initial date to open in the booking calendar page, in YYYY-MM-DD format. |
location | One or more business locations, identified by ID. Use commas to separate multiple location IDs. |
bookingId | ID of an existing booking to reschedule. Note: The site member who booked the original session needs to be logged in. |
To set customized default resources (staff members) or locations, or to reschedule an existing booking, you need to obtain the relevant IDs. You can do this as follows:
To find the ID for a resource using the site dashboard, follow these steps:
/bookings/staff/details/
For example, in the following URL, the resource ID is 76570209-101f-409b-af97-b445bdb63125
:
1
To find the ID for a business location, use listLocations()
or queryLocations()
.
To find an existing booking's ID, use queryBookings()
.
The following are examples of shareable links for a Wix site's booking calendar page with query parameters that set customized default values.
Preset date:
1
Preset date and time zone:
1
Preset resource and location:
1
Multiple preset resources and locations:
1
Booking ID to reschedule an existing booking, with preset date and locations:
1