If you’re using Wix for your website, you can add Hospitable’s booking functionality using widgets. This allows guests to check availability and submit booking requests directly from your Wix site.
However, Wix has some limitations that require additional setup compared to other platforms.
How Wix Integration Works
Wix does not support standard script embeds in the same way as other platforms. Because of this:
Widgets must be added using an HTML embed (iframe)
Additional configuration may be required for booking actions to work correctly
Google Vacation Rentals (GVR) not supported: The Wix iframe embed cannot pass search or itinerary parameters from your page URL, so Google Vacation Rentals won't pick up your listings. If GVR eligibility is important to you, consider using a Hospitable-hosted site instead.
Before You Start
Make sure:
You have a Wix site with editing access
Your properties are eligible for Direct bookings
You have your widget code from Hospitable
To copy your widget code: go to Direct Bookings → Website, select Self Hosted, then click the Copy widget code button under each property in the list You can also use Export widget codes to bulk download codes for all scoped properties — when prompted, select Wix site to generate the correct iframe embed code for each property.
Add the Booking Widget in Wix
Step 1: Enable Dev Mode (Velo)
Open your Wix site editor
Enable Dev Mode (Velo) from the top toolbar
This allows you to add custom code required for the widget to function.
Step 2: Add an HTML Embed
Add an HTML iframe element to your page
Paste your widget embed code into the HTML component
This will display the booking widget on your page.
Step 3: Add Redirect Handling Code
To allow booking actions (like “Request to book”) to work correctly, you need to add a script.
In your masterPage.js, add:
import wixLocation from 'wix-location';
$w.onReady(function () {
$w("#html1").onMessage((event) => {
wixLocation.to(event.data.hospitable_widget_redirect);
});
});
This ensures guests are redirected correctly when interacting with the widget.
Set Up One Page Per Property
For best results:
Create a dedicated page for each property
Add the corresponding widget to each page
This ensures:
Correct booking flow
Compatibility with search and distribution features
Each property must have its own page and widget for proper functionality.
Known Limitations with Wix
Wix embeds widgets inside iframes, which can limit functionality
Some features (like multi-property search) may not be supported
Additional code is required for full functionality
URL validation will show a ⚠️ warning — this does not mean the widget is broken
Some widget features may not work as expected on Wix due to platform restrictions.
The ⚠️ URL validation warning appears because Hospitable's URL check looks for the standard dynamic booking widget on your page. The Wix iframe embed is not detected by this check, so the warning will always show for Wix sites — even when the widget is fully functional and guests can book through it. It only indicates that the iframe embed type used is not eligible for Google Vacation Rentals, not that anything is broken.
Test Your Setup
After adding the widget:
Open your site in a browser
Select dates and interact with the widget
Click “Request to book” to confirm redirects work
Use an incognito window to avoid caching issues.
Troubleshooting
If your widget is not working correctly:
Confirm Dev Mode is enabled
Check that the embed code is complete
Verify the redirect script is added correctly
Ensure your property is eligible
Also see: Troubleshooting Widget Issues
Important Things to Know
Wix requires additional setup compared to other platforms
Widgets must be embedded using HTML components
Redirect handling code is required for booking actions
Each property should have its own page and widget
Some features may be limited due to Wix restrictions