Embed widget
Add a booking widget to your website so clients can schedule appointments without leaving your site.
Last reviewed
Getting the embed code
Allow your website, then copy the embed code.
- Open Calendar › Settings in the sidebar, then the Booking link tab
- Select the Embed section
- In the Allowed domains section, choose Edit, then Add website address
- Enter the address of each website you want to embed on, for example https://www.example.com, and choose Save
- Find the embed mode you want further down the Embed section: Inline embed, Popup embed, Badge widget, Booking card or Appointment list (the Appointment list is shown only on a professional’s booking link)
- Choose Copy code under that mode
- Paste the code into your website’s HTML
Screenshot, for illustration only




Embed modes
Choose how the booking widget appears on your website.
Inline embed
The booking form is embedded directly into your page content. It appears as part of the page and automatically adjusts its height to fit the content. Best for dedicated booking pages on your website.
Popup embed
A button on your page that opens the booking form in an overlay modal when clicked. The modal covers the page content and includes a close button. Best for adding booking to existing pages without changing the layout.
Badge widget
A floating button fixed to a corner of the page it is added to. Clicking it opens the booking form in a popup. Its snippet loads the script and then calls the badge function, so add it to each page where you want the button to show.
Booking card
A compact panel with your logo, your name and a button that opens your booking page.
Appointment list
The appointment types you have made bookable, with how long each one runs. It appears in the Embed section only for a professional’s booking link.
Implementation notes
Important technical details for website integration.
- The embed script loads asynchronously and does not block your page
- The booking form is displayed inside an iframe for security isolation
- The embedded form uses the logo and colour set in the Branding section of your booking link, where your plan allows custom branding
- Inline embeds resize automatically to match the booking form content; the popup and badge modes open in an overlay
- When a booking completes, the widget calls window.onTheWillBookingComplete and fires a thewill:booking-complete event on your page, so you can trigger your own analytics or a thank-you message
Add your website address first
For security, the booking page will only load inside another website when that website’s address has been added to the allowed domains for your booking link. Until then the embed stays blank on your site, even though the code snippet is correct. Add your addresses in the Allowed domains section at the top of the Embed section, as described above.
Security note
If your website uses a Content Security Policy (CSP), you may need to add TheWILL.ai to your frame-src directive to allow the embedded booking form to load.
Related topics
Can’t find what you’re looking for?
Our support team is here to help. Contact us and we’ll get back to you as soon as possible.
Contact us
