Skip to content
Docs menu

Embedding a booking page

Put a booking page on your own site, inline or as a popup, with one script from your own cloud: prefill the name and email, pass utm_* parameters, and hear when someone books.

View .md

One script, served by your own Venom Cloud at /meet/embed.js, shows a booking page on any site. It is plain JavaScript of about 3 KB with no dependencies. It frames only the cloud it was loaded from and listens only to that cloud's frames.

Inline

<div data-venom-meet="ana/intro"></div>
<script src="https://cloud.example.com/meet/embed.js" async></script>

The value is <handle>/<slug>, or l/<token> for a single-use or one-off link. The frame grows to fit the page (start it at another height with data-height="900").

<button data-venom-meet-open="ana/intro">Book a call</button>
<script src="https://cloud.example.com/meet/embed.js" async></script>

Or from your own code:

VenomMeet.popup("ana/intro", { prefill: { name: "Dana", email: "dana@example.com" } });
VenomMeet.close();

The popup closes with Escape, its close button, or a click outside it.

Prefill and tracking

Add data-prefill-<field> to the element to fill the form in advance:

<div data-venom-meet="ana/intro" data-prefill-name="Dana" data-prefill-email="dana@example.com" data-prefill-utm_campaign="spring"></div>

name and email fill the invitee's fields (they can still change them). Any utm_* parameter, from the attribute or from your own page's address, is kept with the booking's answers as utm. The same parameters work on a plain link: /meet/ana/intro?name=Dana&utm_source=newsletter.

When someone books

The page tells your site, and the script fires a DOM event:

document.addEventListener("venom-meet:booked", (e) => {
  console.log(e.detail.path, e.detail.booking_id, e.detail.start);
});

Inside a frame, the page stays on its own confirmation instead of following the event type's redirect URL.

Privacy

The script and the page load nothing from anywhere else, set no cookies and send no referrer. The page's content security policy allows it to be framed by any site, and nothing else.