1. Cloudbeds
  2. Configuration Hub
  3. Cloudbeds Booking Engine
  4. Booking Engine Settings

How to redirect your guests to a particular room type and/or rate plan in Cloudbeds PMS?

Gabriela Garcia
Updated

This article will walk you through creating a custom Booking Engine link that will redirect the guest to a particular room type or rate plan in your Booking Engine.

To create a custom URL for your guests' bookings through Booking Engine, use your Booking Engine direct link + parameters from the sections below. Depending on where you would like to redirect your guests—a specific room, rate plan, or base rate—you may create your custom Booking Engine URL using any of the parameters provided below. 

  Notes:

  • To find the link to your booking engine in Cloudbeds PMS, please go to Account Account menu icon.png -> Settings Settings icon.png -> Booking Engine -> Summary.
  • The blurred code between the word "reservation/ " and the " #room_type=" is your unique Booking Engine code. This is part of your constant Booking Engine link (you don't need to add this information manually)

List of Variable Parameters

Find the following scenarios and codes to add to your Booking Engine URL below.

https://hotels.cloudbeds.com/reservation/YourUniqueCode/add the parameter here

 Disclaimer: some of these might not be compatible with the Booking Engine Plus (also known as Cloudbeds Booking Page v3).

Room type
#room_type=add room abbreviation here

To find the accommodation abbreviation:

  1. Go to Account Account menu icon.png, select Settings Settings icon.pngand click on Property Property icon.png
  2. On the Accommodations tab, check the Accommodation Abbreviation column information

Only Classic Rooms and linked rate plans will be displayed if this parameter is added.

Room type (base rates only)
#room_type=add room abbreviation here&base_rates_only=1
Number of Adults and Children
#adults=number of adults&kids=number of children

We recommend using this parameter alongside the room type code. If used alone, the system will display all available rooms and select the number of occupants based on capacity.

The images below exemplify what the Booking Engine (Old version) and Booking Engine Plus (Cloudbeds Booking Page V3) look like when we use the parameters #checkin=2024-12-02&checkout=2024-12-07&adults=2&kids=2. Although we specify that we want to book for 2 adults and 2 children, the booking engine shows the following:

    • Standard room: Only 1 adult is selected because the Maximum Occupancy is 1 pax.
    • Double room: Only 2 adults are selected because the Maximum Occupancy is 2 pax.
    • Deluxe room: 2 adults and 2 children are selected because the Maximum Occupancy is 4 pax.

The booking engine's latest version (Booking Engine Plus) shows the total number of Guests, but when you click on the drop-down menu, you will see the breakdown of adults and children.

Rate plans
Cloudbeds Booking Engine (Old Version)
  • The rate plan with promocode will only work by redirecting the user to URL containing this promocode. You may find the link with promocode on rate plan page in Cloudbeds PMS.

Rate plans Booking Engine (Old Version) 0.png

  • Use the "Rate Plan Name (private)" value for this. If the parameter is added, the system will display results only for that rate plan.

For example: Let's say you have 2 rate plans on your property. The "Rate Plan Name (private)" can be checked directly on the 'Rate Plans & Packages' page. (Rates & Availability -> Rate Plans & Packages)

Rate plans Booking Engine (Old Version) 1.png

In this example, we'd like to have only one rate plan displayed. This would show results only for the promo rate plan. As we can see now only the one rate plan specified is displayed.

Rate plans Booking Engine (Old Version) 2.png

Cloudbeds Booking Engine Plus (Cloudbeds Booking Page V3)

When you create or edit a Rate Plan, you can set them a promotion code.

  • If you create a promo code:

Find the link with the promo code on the Rate Plan page in Cloudbeds PMS.

In this example, we'd like to display only one rate plan. The link will show results only for that promo rate plan, like this:

  • If you don't create a promo code:

  Unless a promotion code is set, prospective guests will see all rate plans and packages in addition to your base rates if you manually add the parameter "Rate Plan Name (private)" to your Booking Engine URL.

For example:

Let's say that from the Rate Plans & Packages page, you copy the Rate Plan Name (private) of a rate plan for which you did not set up a promo code.

And add the code below to your Booking Engine URL.

#promo=rate plan private name

The system will still apply the code in the "Have a promo code?" bar (highlighted in yellow in the image below).

Nonetheless, after customers select the dates (step a) and click on search (step b) all rate plans and packages will be visible to prospective guests.

  If the rate plan contains spaces, keep them in the URL. Then, copy the URL (together with spaces) and paste it into the browser. Click ENTER. The browser will fill the spaces with symbols.

For example, this URL has a space between the words "test"_"test"

https://hotels.cloudbeds.com/reservation/YourUniqueCode/#promo=test test
Therefore, the link will redirect to 
https://hotels.cloudbeds.com/reservation/YourUniqueCode/#promo=test%20test

  Make sure to write the rate plan private name exactly as it's written in 'Rate plan & Packages'. If the name is written with a capital letter, it should be written the same way in the URL parameters; otherwise, the parameter won't work.

  It's not possible to redirect to 2 rate plans if they both are available only with promo code.

Room type and rate plan at the same time
#room_type=add room type abbreviation here&rate_plan=add internal rate plan name here;

For this example, let's use the room_type=DOU, which is the abbreviation for a Double Room, and rate_plan=promo which is the abbreviation for an rate plan promotion.

As we can see by using this parameter, only the room and specified rate plan will be displayed.

Room type and rate plan at the same time - Old Booking Engine.png

Room type and 2 different rate plans

  It's not possible to redirect to 2 rate plans if they both are available only with promocode. As a solution you can remove the promocodes from the rate plans.

#room_type=add room type abbreviation here&rate_plan=add private rate plan 1 name here;add private rate plan 2name here&checkin=2018-01-12&checkout=2018-01-13

Room type and 2 different rate plans.png

2 different room types with the same rate plan
#room_type=add room 1 type abbreviation here;add room 2 type abbreviation here&rate_plan=add private rate plan name here

For example:

#room_type=DOU;DQL&rate_plan=Promo

2 different room types with the same rate plan.png

2 different room types with 2 different rate plans

  It's not possible to redirect to 2 rate plans if they both are available only with promocode. As a solution you can remove the promocodes from the rate plans.

#room_type=add room 1 type abbreviation here;add room 2 type abbreviation here&rate_plan=add private rate plan 1 name here;add private rate plan 2 name here&checkin=2018-01-12&checkout=2018-01-13

For example:

#room_type=DOU;DQL&rate_plan=Promo;Test&checkin=2018-01-12&checkout=2018-01-13

2 different room types with 2 different rate plans.png

Redirecting your guests directly to the confirmation page
#room_type=accommodation abbreviation&rooms=number of rooms&rate_plan=name of the rate plan(private)&adults=number of adults&kids=number of children&checkin=year-month-day&checkout=year-month-day&submit=1

For example:

#room_type=DLX&rooms=1&rate_plan=High%20Season%20Travel%20Agencies &adults=2&kids=2&checkin=2018-01-11&checkout=2018-01-12&submit=1

    • #room_type=DLX - accommodation abbreviation
    • &rooms=1 - total of rooms
    • &rate_plan=High%20Season%20Travel%20Agencies - the specified rate plan will be displayed. 
    • &adults=2 - number of adults
    • &kids=2 - number of children
    • &checkin=2018-01-11&checkout=2018-01-12 - days of stay
    • &submit=1 - the guest will be redirected to the confirmation or check-out page

  For the code submit=1 to work, your link must specify the room type, number of rooms, number of guests, and the check-in and check-out dates. Otherwise, the page will give you an error.

 The rate plan parameter is optional. If you don't include it in the URL, the system will show the base rate by default.

Redirecting your guests directly to the confirmation page using a particular rate plan or base rate for 2 different room types
#room_type=accommodation abbreviation 1;acommodation abbreviation 2&rooms=number of rooms&adults=number of adults&kids=number of children&rate_plan=name of rate plan (private)&checkin=year-month-day&checkout=year-month-day&submit=1

For example: #room_type=DOU;DLX&rooms=2&adults=1&kids=1&rate_plan=High%20Season%20Travel%20Agencies&checkin=2024-12-09&checkout=2024-12-14&submit=1

    • #room_type=DOU;DLX - accommodation abbreviation. 
    • &rooms=2 - total of rooms per room type
    • &adults=1 - number of adults
    • &kids=1 - number of children
    • &rate_plan=High%20Season%20Travel%20Agencies - the specified rate plan will be displayed. 
    • &checkin=2024-12-09&checkout=2024-12-14
    • &submit=1 - the guest will be redirected to the confirmation or check-out page

Redirecting to group booking widget with city and dates of stay pre-selected

In order to use this option you need to have a group of properties within Cloudbeds - Groups.

Use your Groups URL (which redirects to your group booking engine) and add the following parameter to it:

(paste your group booking engine URL here)/#/?city=(enter name of city here)&check_in=15/07/2018&check_out=25/07/2018&page=1

Here is how your URL may look like:

https://hotels.cloudbeds.com/#/?city=London&check_in=15/07/2018&check_out=25/07/2018&page=1

  For advanced options, refer to this article: Advanced Option: Building a Group Booking Widget

Was this article helpful?
4 out of 6 found this helpful

Comments

0 comments

Please sign in to leave a comment.