How to create a new booking product

In order to create a booking system, you should first create “Booking” products.
Only after a correct configuration of the product, you will be able to receive bookings/reservations for this product.

Create a new WooCommerce product and select the “Booking Product” type.

Booking product

Once you have selected the “Booking product” type, an option will appear to set the product as virtual or non-virtual to allow shipping.

virtual option

Now you can go on and configure the booking settings.
Please, read this handbook carefully to learn how to use the plugin correctly.

Google Map API KEYS

To set the location for your products, the plugin uses Google Maps services. So the first step is to insert the“Google Maps API Key”.
Access Google, go to, and click on “Get a key”.

Google Maps API KEy authentication

After selecting the project, in the next step, you will obtain the key required by the plugin

Google Map API KEY

Copy and paste the key intoYITH Plugins -> Bookings -> Google Maps API Key.



Now access the product, type in the name of the location you wish to select and you are done.

Select location

You can set set 2 different API Keys for:

  1. Google Maps API Key
  2. Google Maps Geocode API Key

Google api key settings

To set them correctly, you should to create 2 different API Keys in Google Console:

1. The Google Maps API Key can be restricted through HTTP referrers.

api key settings google

2. The Google Maps Geocode API Key can be restricted through IP addresses

api key settings google

How to display the map

By entering the shortcode [booking_map] within the Booking product page, the Google map linked to the product location will be automatically displayed.


The shortcode attributes are:

  • width: map width
  • height: map height
  • zoom: map zoom level
  • type: map type, choosing from:
    • roadmap: displays the default road map view. This is the default map type.
    • satellite: displays Google Earth satellite images
    • hybrid: displays a mixture of normal and satellite views
    • terrain: displays a physical map based on terrain information.

Usage example: [booking_map width=”300px” height=”300px” zoom=”100″ type=”satellite”]

Set fixed duration for the booking

The duration of the booking can either be defined by the admin as a preset time frame or by the user through the dedicated input form in the product detail page.
PLEASE NOTE: the duration of a booking is expressed in booking units, days, months, hours, and minutes.

When the admin defines the default booking duration, users are only asked to enter the start date.



The booking end date is automatically calculated.
In this case, the booking is for 5 days.


Let users choose the duration

It works differently if you let your users select the duration of their booking.
First of all, you have to define your booking unit.


The booking unit allows the system to calculate the duration of the booking dynamically, based on the quantity set by users in the “Duration” field. It will be calculated as the product of two factors, the value entered by the user (3 in the screenshot below) multiplied by the booking unit set by the admin (3 in the screenshot above).


Suppose you have set the booking unit to “3 days” (as shown in the image above), and that the user has typed “3” as the value for his booking duration, the “total duration” of the booking will be 9 days.
The end date will be automatically calculated as soon as the user selects the start date.


Another option is the unit “minutes“, you can choose between blocks of 15, 30, 45, 60 or 90 minutes.

Booking unites minutes

Calendar range picker

Only if you have set 1 day as booking unit (and therefore selected also the option “Customer chooses units of”), an interactive calendar will appear to let your users select the booking date.

Enable date picker


The duration is automatically calculated.


You can decide to show the dates in a unique field by enabling the option Enable Unique Calendar Picker in the Booking Form section.


Minimum and maximum booking duration

If you let your users select the duration of their booking/reservation, you can set minimum and maximum values for it in the product settings page. This way you can prevent users from making a booking/reservation for longer or shorter than allowed.
If you don’t want to set any limits to the booking duration, enter “zero” into the concerned field.

Minimum and maximum duration of the booking

Let’s make an example. Suppose we want to allow bookings for the flat “Residenza Marina” in units of three days and for a maximum of 7 units (21 days, then).

To do that, we can configure the product as follows:

  • Booking duration: customer chooses units of 3 days
  • Minimum duration: 1
  • Maximum duration: 7

Configure booking duration - Example

Consider min/max duration in calendar

By enabling the check min/max duration option, the calendar in frontend will show the dates which are no longer available, including the minimum/maximum duration.

min max duration

For example, customer A has booked the Amsterdam Room from 12 July – 18 July. The minimum duration to book this room is 3 days, therefore it is not possible for Customer B to book the room from 10 to 18 July, considering the minimum of 3 days plus the booked period.


If you disable the option, the customer will see the calendar with the dates available/unavailable, however it does not take into consideration the minimum and maximum duration of the room. Therefore the days prior to the reservation will appear clickable in the calendar, even if the booking is not available on those dates.

min duration disabled

If the customer wants to book the room from 10 – 14 July will get a message that it is not possible to book this room in the period he wishes.

not available



General information about booking availability

Users make a booking based on the dates that the system shows as available.
Availability can either be configured globally or from within the specific “booking” product.

Global availability


Product availability

booking avail

Unavailable dates become unselectable for upcoming users.

Whether you are acting globally or on the single “booking” product, you’ll be able to create availability rules that apply only to one or more months or to a preset range of days and dates.
Let’s see how to do that.

Configure date/month range of the availability

First of all, we must select the time frame for which the availability rule shall be configured. You can choose between “Date range” and “Month range”.

Date range


Month range


To edit the availability status for the selected time frame, click on the button shown in the following image.


This way, no bookings can be made for the selected time frame.

Click on the icon shown in the image below to configure availability for each day of the week within the selected time frame.

Availability by day of the week