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

Gabriela Garcia

Updated April 17, 2026 21:11

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 -> Settings -> 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

Room type

#room_type=add room abbreviation here

To find the accommodation abbreviation:

Go to Account , select Settings , and click on Property
On the Accommodations tab, check the Accommodation Abbreviation column.

In this example, the Executive room uses the abbreviation EXE, so your Booking Engine URL could look like:

https://hotels.cloudbeds.com/en/reservation/YourUniqueCode/?currency=usd&checkin=2025-12-19&checkout=2025-12-20#room_type=EXE

On Booking Engine Plus, this parameter highlights the selected room type (for example, the Executive room) at the top of the results, but other available room types will still appear below in the Discover more options section.

This section is built into Booking Engine Plus and cannot be removed through settings or URL parameters.

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 Cloudbeds Booking Engine Plus looks like when we use the parameters &checkin=2026-07-15&checkout=2026-07-18&adults=2&kids=2.

Cloudbeds Booking Engine displaying search results for 2 adults and 2 children via URL parameters. Clicking the 'Add' button confirms the guest breakdown for the selected room.

Rate plans

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=PRI (Private Room) and the promo=FiveStarsXE (All Inclusive Five Star Experience). This combination allows you to link guests directly to a specific room sold under a specific rate.

If the specific room type and rate plan combination is unavailable for the selected dates, the Booking Engine Plus will display a notification and show the availability calendar so the guest can choose alternative dates (as seen in the first image below).

Booking Engine showing unavailability message and calendar — The Booking Engine displays an error message and the availability calendar when the specific room and rate plan combination is not available for the selected dates.

When the combination is available, the system highlights that specific room and rate plan at the very top of the results to ensure it is the first thing the guest sees.

Booking Engine highlighting specific room and rate plan — A successful redirect where the Private Room (PRI) and the Five Star Experience rate plan are prioritized. Note that other available rooms still appear under "Discover more options.

Note: Just like with individual room parameters, the "Discover more options" section cannot be hidden, but the URL parameter ensures your preferred selection is the primary focus.

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

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

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

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