Overview
The Embeds tab is the location for Booking Engine embed options in Cloudbeds PMS.
It includes Basic Embeds, which are widget options, and Premium Embeds, which include Immersive Experience 2.0 and related web component solutions.
Use this article to learn which embed options are available, how Premium and Basic Embeds differ, and how to copy or access the setup instructions for each embed type.
What are Embeds?
Embeds are Booking Engine components that can be added to your website to help guests start or complete their booking journey.
Depending on the option selected, an embed can:
- Show a booking widget with check-in and check-out dates
- Open a booking button that redirects guests to the hosted Booking Engine
- Display a date picker for a specific property, multiple properties, or a specific accommodation
- Display the full Immersive Experience 2.0 booking flow on your website
The Embeds tab is divided into two sections: Premium and Basic.
| Section | What it includes | Best used for |
|---|---|---|
| Premium Embeds | Immersive Experience 2.0 and related web component solutions, including date picker components. | Properties that want a more complete embedded booking experience, real-time availability, tracking support, and advanced setup options. |
| Basic Embeds | Simple widget options such as Stacked, Horizontal, Floating, Large Button, and Small Button. | Properties that need a simple way for guests to start the booking process and continue in the hosted Booking Engine. |
How to access the Embeds tab
- From your Account menu, go to Settings
- Click Booking Engine
- Select the Embeds tab
Available Embed types
Premium Embeds
The Premium section includes embed options connected to Immersive Experience 2.0 and related web component solutions.
Immersive Experience 2.0 Standard and Overlay
A full Booking Engine experience hosted on your property's website.
- Use this option to let guests browse availability, select rooms, and continue through the booking flow directly on your website
- It helps keep guests within your website environment throughout the booking journey
- Choose between the Standard or Overlay layout, depending on your website design and preferred guest experience
Within the Immersive Experience 2.0 booking flow (pop-up and full-page), guest search details—including dates, number of guests, promo codes, selected rooms, and checkout progress—are automatically preserved for up to 10 minutes of inactivity. If a guest briefly leaves the booking flow and returns within this timeframe, they will resume exactly where they left off, creating a smoother booking experience and reducing potential drop-off.
Single Property Date Picker – Horizontal and Vertical
Easy to use booking date selector that displays availability and price at a glance.
- You can use this option when you have one property and want a simple check-in and check-out search bar on your website
- It works well on a homepage, hero section (top most prominent area of a webpage), or booking section where guests can begin the booking process quickly
- You can choose a horizontal or vertical layout, depending on the design of your website
- After guests select dates, they are redirected to the Booking Engine to continue the reservation process
Related article: Single Property Calendar - Date Picker Embed
Multi-Property Date Picker – Horizontal and Vertical
Easy to use booking date selector that displays availability and price at a glance across all your properties.
- You can use this option when you manage multiple properties and want guests to choose a property and dates from one booking component
- It works well for brand, group, or organization websites that need a centralized booking selector
- You can choose a horizontal or vertical layout, depending on the design of your website
- After guests select a property and dates, they are redirected to the Booking Engine for that selected property
Related article: Multi-property Calendar - Date Picker Embed
Accommodation Date Picker
This provides a simple way to add a Book Now button for a specific room on your website without rebuilding your entire booking flow.
- You can use this option when you want to promote a specific room or accommodation on your website
- It works well for room detail pages, landing pages, or promotional pages focused on a specific accommodation
- Guests can select dates before continuing, which helps guide them to the correct accommodation in the Booking Engine
- This option adds a Book Now button for a specific room or accommodation without requiring a full booking flow redesign
Related article: Accommodations Calendar - Date Picker Embed
Basic
The Basic section includes simple widget options that help guests begin the booking process and continue in the hosted Booking Engine.
Stacked
Check-in and check-out dates appear in a stacked box with little extra information.
Horizontal
Check-in and check-out dates appear in a horizontal box with little extra information.
Floating
Check-in and check-out dates are displayed in a dark banner, along with a brief message encouraging your customers to book.
Large Button
This embeds a button only with no date picker that redirects the guest to your Booking Engine.
Small Button
This embeds a button only with no date picker that redirects the guest to your Booking Engine.
How to use Embeds
The steps depend on whether you are using a Premium or Basic option.
Use a Premium embed
Important: Premium Embeds access depends on your Cloudbeds subscription. If Premium Embeds are not included in your package, the Premium section may display a Contact sales option.
Click Contact sales to request more information about upgrading to a package that includes Premium Embeds.
- Go to Booking Engine > Embeds
- In the Premium section, select the desired option
- Add or confirm your Whitelisted domains
- Open the Installation guide by clicking View
- Premium Embeds require separate implementation steps and may include script installation, website configuration, and property-specific details, depending on the selected option.
- Follow the dedicated setup instructions for that specific Premium embed type
Use a Basic embed
- Go to Booking Engine > Embeds
- In the Basic section, choose the widget type
- Adjust the available settings, such as language and whether to open the booking page in a new window
- Copy the code shown in Code preview
- Paste that code into your website or website builder page
Basic Embeds are intended for simpler implementations. Select the widget type, adjust the available settings, copy the code, and paste it into your website.
Important: Do not use Immersive Experience 2.0 web component tags inside iframes. This setup can cause display and scrolling issues and is not recommended.
Important considerations
- Premium and Basic options are different solutions. The Embeds tab groups both modern premium components and basic widget options on a single page, but their setup processes are not the same.
- Premium Embeds require dedicated setup instructions. Always use the Installation guide shown in the Embeds page for the selected Premium option.
- Whitelisted domains are important for Premium Embeds. Premium embed solutions connected to Immersive Experience 2.0 rely on domain authorization to function correctly.
- Website compatibility may vary. Some custom-built websites support these implementations more easily than some template-based or no-code site builders.
- Cloudbeds cannot add code to your website for you. If you need help adding scripts or widget code to your website, contact your website developer, designer, or website provider.
Embeds FAQ
Why can I see Premium Embeds but not use them?
Access to Premium Embeds depends on your Cloudbeds subscription. If Premium Embeds are not included in your package, the Premium section may display a Contact sales option.
Click Contact sales to request more information about upgrading to a package that includes Premium Embeds.
What happens if I don’t add a domain to Whitelisted domains?
For Premium embed solutions tied to Immersive Experience 2.0, your website domain must be added to Whitelisted domains so Cloudbeds can authorize requests coming from your website.
Without the correct domain added, the Premium embed may not work correctly.
To add your domain correctly and complete the setup for Premium embeds, see the How to install the Immersive Experience 2.0 section in the Immersive Experience 2.0 article.
Do I need the Installation guide for ALL embed types?
No. The Installation guide is especially important for Premium embed types, since each one may have specific implementation requirements.
For Basic embed types, the process is simpler: select the widget, copy the code, and paste it into your website.
Comments
Please sign in to leave a comment.