Developer Reference
postMessage events and integration hooks for building custom experiences on top of RentalBeam widgets.
Available onFreePlusPro
Nothing in this section is needed to use the widgets. Putting one on a page is a snippet and no code. These pages are for whoever builds your website, on the day you want the site itself to react to what a guest picks.
RentalBeam widgets communicate with the parent page through postMessage: the booking widget emits events when a guest selects or clears dates, and the calendar widget accepts an inbound message to switch its theme. You can hook into these from any page where a widget is embedded.
Plan requirements
| Feature | Free | Plus | Pro |
|---|---|---|---|
| Calendar widget (theme inbound event) | ✓ | ✓ | ✓ |
| Booking widget postMessage outbound events | - | - | ✓ |
In this section
- postMessage events: outbound booking events, the event envelope, a Wix Velo example, and the inbound theme control.
- Search then book on another page: a guest picks dates on one page and lands on the right rental's page with those dates filled in.
- Embed loader reference: every data-* container attribute for both widgets, in one table.