Cloudbeds Booking Engine is our commission-free booking engine fully controlled by Cloudbeds PMS (Property Management System). This article answers the most frequently asked questions about this feature.
If you are having issues with the booking engine, see: Cloudbeds Booking Engine - Troubleshooting
Frequently asked questions
How can I insert the booking engine to my hotel's website?
The Cloudbeds Booking Engine Immersive Experience 2.0 is a modern, fully web-based solution designed to embed seamlessly into your property’s website. It provides guests with a smooth, secure, and user-friendly booking experience—complete with PCI-compliant payments and Google compatibility data tracking for insights from page view to purchase.
Because it’s a web-based component, there’s no need for complex whitelisting or masking processes. Integration is as simple as embedding code snippets directly into your website, allowing the booking engine to blend perfectly with your site’s look and feel.
The Immersive Experience 2.0 offers two flexible embed options:
- Option 1 - Full-page embed: Displays the complete booking engine directly on a webpage, offering guests a fully immersive, uninterrupted booking journey. You can copy your Booking Engine URL and paste it into your website. There are no limitations — it can be embedded on any subdomain of your property’s website.
- Option 2 - Pop-up embed: Launches as a sleek side panel that slides in from the edge of the screen when guests click “Book Now,” enabling bookings without leaving the current page. Follow the instructions for the Booking Engine Website Widget code and paste it into your website.
Both options deliver a seamless integration designed to enhance your guest experience and simplify your setup.
Important: Immersive Experience 2.0 is not supported in iframes
Do not use Immersive Experience 2.0 web component tags inside iframes. This setup can cause scrolling issues and would require whitelisting every item in the iframe chain — a configuration that is not recommended.
Why is the Immersive Experience 2.0 pop-up not loading on my website (for example, on Wix or other iframe-based embeds)?
If the Immersive Experience 2.0 pop-up is not loading on your website builder (for example, when using Wix HTML / embed elements), check whether the code is being inserted inside an iframe (such as a wix-iframe container).
Immersive Experience 2.0 web component tags (for example, cb-immersive-experience and cb-book-now-button) must not be used inside iframes.
This setup can cause scrolling and rendering issues and would require whitelisting every item in the iframe chain, which is not recommended.
Does Cloudbeds Booking Engine comply with Accessibility Standards?
- The Web Content Accessibility Guidelines (WCAG) defines requirements for designers and developers to improve accessibility for people with disabilities. It defines three levels of conformance: Level A, Level AA, and Level AAA.
- We have tested our booking engine to ensure that we meet or exceed Level AA checkpoints of the WCAG 2.1 Standard. To learn more, visit the Cloudbeds Accessibility Policy.
Is URL masking supported?
We now offer a much simpler and more powerful solution than traditional URL masking or whitelisting.
With the Cloudbeds Booking Engine Plus Immersive Experience 2.0, you can embed the booking engine directly into your property’s website—no complex configurations, whitelisting, or masking required. This modern, fully web-based component integrates seamlessly through a simple embed, delivering a smooth, secure, and guest-friendly booking experience that looks and feels native to your site.
Learn more about the Immersive Experience 2.0.
Can I promote special offers with the booking engine?
Yes, with Cloudbeds PMS controlling the booking engine, you may create Rate Plans & Packages (with promo code if necessary) that can be displayed and sold on the booking engine page.
Learn more about How to Add Rate Plans and Packages
Is it possible to sell my rooms only with (promotional) rate plans on the booking engine?
Yes, you can configure the system to display only your promotional rate plans and packages (without the base rates) on the booking engine. Learn more: How to sell my rooms only with (promotional) rate plans and packages on the Booking Engine.
Do you offer booking engine customization?
- Learn more about the Cloudbeds Booking Engine Plus customization services
- Cloudbeds also offers Cloudbeds Websites (Professionally built websites that are fully integrated with the Cloudbeds Booking Engine, channel manager, and PMS). Click here for further details.
Can I charge the guests directly on the booking engine?
- Yes. If you have Payment Processing enabled in Cloudbeds PMS, you may set up a deposit amount to be charged immediately when making a reservation or certain days before the guest's arrival.
- You can also collect guests' credit card details to charge your guests later for their stay. Learn more: How to set up automatic/scheduled payment processing for OTAs and Cloudbeds Booking Engine
- It is possible to add a custom payment gateway to your Booking Engine Plus. Learn more here.
How do I know what payment method the guest used to make booking engine reservations?
The payment information from your booking engine reservation is visible in the reservation header.
On the reservation summary received via email, the payment method is also visible.
To receive this type of email, set up the property email address under the System Notification Preferences
Can I customize the check-in & check-out window in the search tab?
Cloudbeds Booking Engine will display the check-in and check-out date based on the lowest Minimum Length of Stay (MinLOS) configured in the system. The system always takes the lowest MinLos within the base rate and also the rate plans.
Example:
- The lowest MinLos in the system for July 14 2020 is 2 nights
- By default, the booking engine will display the check-in date 14/07/2020 and the check-out date 16/07/2020 in the search tab (2 days gap)
I have different MinLOS/MaxLOS for my base rates and rate plans, why the Availability Calendar is only showing one and not the other?
For the moment, only a limited number of restrictions are available to view on the availability calendar. Learn more about restrictions display in the Availability Calendar here.
Is it possible to configure the booking engine to load a minimum of 2 nights by default?
Currently, it is not possible for the Booking Engine to load two nights by default. As a workaround, you can add a notification under the search button to provide more details about your applicable restrictions.
Can I replace the room name with the rate plan name in the restriction window on the Availability Calendar?
- No, it is not possible to replace the name of the room type with the rate plan name on the Availability Calendar.
- The calendar shows the name of the room type along with the length of stay restrictions by default.
There is no lock icon next to the booking engine URL on the browser. Is it secure?
Scenario
When my guest clicks on Book Now, they are redirected to the booking engine but there is no lock icon next to the browser URL like shown below:
How could this happen, and is it secure?
This could happen when using images from an unsafe server through the CSS code. It means that the CSS image URL that you are using is affecting/hiding the lock icon from your booking engine page (example: background image). Nevertheless, the booking engine continues to be secure.
If you add any URL on the customization page that is not HTTPS, it will hide the lock, but it doesn't mean that our booking engine became an unsecured site to your guests.
How does the booking engine calculate the number of people included in the rate?
The Booking Engine calculates the number of people included in the rate based on your accommodation setup on Cloudbeds PMS.
To verify your accommodation setup:
- Go to the Property section in your Settings page
- Go to the Accommodations tab
- Click on the accommodation name to verify your setup
Learn more about how to Create and manage your accommodation types
- Check the Maximum Occupancy and Adults (or Children) included in rate
Refer to this article for the detailed instructions on How to add extra person fees
- Example: Let's say in the room configuration you include 2 adults and 2 children in the rate and Maximum Occupancy is set as 5
- This setup means the guests will be able to book 2 adults + 2 children with no extra charge:
Is it possible to replace the Cloudbeds Booking Engine with a different booking engine?
Currently, it is not possible to connect any other booking engine to Cloudbeds PMS. For more information, reach out to the Support Team.
Why am I getting "This Connection is Not Private" message when clicking on the booking engine link?
Make sure there are no WWW. within the booking engine URL. Use the exact URL provided inside Cloudbeds PMS as it is secure and consists of the HTTPS secure protocol.
- Go to your Account menu
and click on the Settings
- Go to Booking Engine
- Use the link to your booking engine in the Where is my Booking Engine? section
How does the Booking Engine work with the number of guests in beds?
- For properties with shared (dorm) rooms, the Booking Engine automatically pre-selects the number of beds based on the number of adults and children specified during the search.
- This aligns with Google’s requirements, ensuring a smoother booking experience and avoiding issues where dorm properties were previously blocked from appearing in Google searches.
Why don’t I see the “Rate Details” button for a Base Rate?
The “Rate Details” button only appears when the Base Rate includes additional information, such as:
-
Occupancy-based pricing
-
Add-ons (e.g., breakfast, resort fees)
-
Special policies (cancellation, deposit, etc.)
If the Base Rate has no extra details, the button is deliberately hidden.
There's also a difference depending on the Booking Engine version you use:
- Booking Engine Plus (v3): The button expands only when there are policy details to show.
- Legacy Booking Engine (v2): Behavior may vary slightly, but the button still only appears for rates with extra details.
This is expected behavior. To show the “Rate Details” button, you would need to add extra information to the Base Rate.
⚙️ Transition Now to the Cloudbeds Booking Engine Plus Immersive Experience 2.0
The old booking engine iframe will soon be discontinued. To ensure your property continues to receive bookings seamlessly, transition to the Immersive Experience 2.0 before the end of the year. The upgraded Cloudbeds Booking Engine Plus offers faster performance, a modern design, and improved conversion rates.
Learn more and make the switch today: Cloudbeds Booking Engine – Immersive Experience 2.0: Everything You Need to Know.
Comments
how do I know the best way to set the maximum occupancy and the Adults Included in Rate and the Children Included in Rate for my different accommodation types?
Hello, Kevin!
Thank you very much for posting this comment!
Please contact our Support Team for further assistance on how to set up your maximum occupancy for adults and children included in the rates.
We remain at your disposal if you have any other doubts.
Regards!
My hotel is experiencing a problem where guests cannot book a room when vacancies are available on the day. For example, my guest cannot book today's room while we have enough vacancies today.
Hello, Tony Chen,
We have created a new ticket for you so that our Support Team can review this carefully and offer assistance as soon as possible.
Kind regards,
Please sign in to leave a comment.