Embed Linkssi bookings and lead forms on your website (embed.js and iframe)

Your link-in-bio page is one entry point. Your main website, landing pages, and client portals are others. Linkssi lets you reuse the exact same booking and lead-form experiences off-platform: paste a short script and markup, or an iframe, and visitors complete the flow without you maintaining a second copy of fields or availability.

This guide explains embed.js, data-linkssi-booking and data-linkssi-form, popup vs inline modes, the ?embed=1 iframe pattern, how auto-resize works, and where to copy snippets in the dashboard.

Not what you need? For YouTube / Spotify / TikTok blocks on your Linkssi page, see Rich media embeds.

Two ways to embed: JavaScript loader or iframe

Option A — embed.js (popup or inline)

1. Add one script tag pointing at embed.js on your Linkssi origin (the same host people use for your pages—linkssi.com, app.linkssi.com, or your custom domain when it serves your Linkssi site):

<script src="https://your-linkssi-host/embed.js" async></script>

1. Add markup Linkssi recognises:

Booking (popup launcher — default)

<a href="#" data-linkssi-booking="page-slug/event-slug" data-linkssi-mode="popup">Book a time</a>

Booking (inline — growing iframe)

<div data-linkssi-booking="page-slug/event-slug" data-linkssi-mode="inline"></div>

Lead form (popup)

<a href="#" data-linkssi-form="page-slug/form-slug" data-linkssi-mode="popup">Open form</a>

Lead form (inline)

<div data-linkssi-form="page-slug/form-slug" data-linkssi-mode="inline"></div>

Replace page-slug, event-slug, and form-slug with the values shown in your dashboard (the editor builds the full snippets so you do not have to memorise them).

Popup mode intercepts clicks, opens a styled overlay, and loads an iframe to the same URL your public booking or form page would use, with embed=1 added. Inline mode injects the iframe directly into your layout.

Option B — Raw iframe

Paste an iframe whose src is your public booking or form URL with ?embed=1 (or &embed=1 if the URL already has query parameters). The dashboard generates a ready-made tag with suggested min-height and title—tweak width to match your theme.

Auto-height and postMessage

Embedded form and booking pages measure their content and send linkssi:embed:height to the parent window. embed.js listens and stretches the inline iframe so you do not get double scrollbars or clipped thank-you messages. If you use a raw iframe without the script, set a generous min-height or accept manual height tuning.

Where to copy snippets in Linkssi

• Bookings — Open Bookings, choose the page, go to Event types, open an event, and use the embed / share UI. You will see the popup, inline, and iframe variants for that event.
• Lead forms — Open the form editor for a specific form. The share area lists the same three patterns for data-linkssi-form.

Because both flows render the normal public URLs with embed=1, any change you make in the dashboard—fields, copy, availability, event settings—shows up immediately on every site where you pasted the embed. There is no widget version number to bump.

Custom domains and origins

Load embed.js from the same origin your Linkssi pages use when visitors click through. If your public bio lives on links.yourbrand.com, reference https://links.yourbrand.com/embed.js so identifiers and redirects stay consistent. The script resolves its own origin from the src URL.

You can also pass a full HTTPS URL as the attribute value where the product supports it (see dashboard snippets) so custom-domain paths stay explicit.

Data and security

embed.js only builds iframes and UI chrome. Form posts still go to Linkssi /api/leads/submit and booking actions to the booking API—the script does not read or intercept field values. Your CMS only hosts the loader and placeholder elements.

If your site has a strict Content-Security-Policy, allow framing and script src for your Linkssi host, and frame-src (or child-src) for the same origin you load the iframe from.

SEO and analytics

Embeds keep the transaction on your domain’s trust path when you use your Linkssi hostname consistently. For SEO, the parent page still carries your normal metadata—the iframe content is typically not indexed as part of the parent URL, which is expected for apps. Track conversions with your usual analytics on the parent page (button clicks) or rely on Leads and Bookings inside Linkssi for completions.

Frequently asked questions

Can I use multiple embeds on one page? Yes. Each placeholder can reference a different event or form.

Does inline or popup rank better? That is a UX choice. Popups keep long flows off the article body. Inline keeps everything visible for short forms.

What if nothing opens? Confirm embed.js loaded (network tab), attributes use the page/event or page/form ids from the dashboard, and your browser console shows no CSP blocks.

---

Pair this with the bookings and leads guides for setup inside Linkssi, then paste the snippets wherever your main site gets traffic. Features · Pricing · Start free