Skip to content
Docs home

CUSTOMIZATION · UPDATED AUGUST 2026

Embeds

Put QUE booking anywhere with the embed script: inline mount, popup, or floating button — with color, label, and prefill control.

The embed script

QUE serves a per-tenant booking widget as a plain JavaScript file. The script URL is formed from the tenant's slug and accepts configuration through query parameters.

htmlEmbedding the booker
<script src="/api/public/embed/your-slug.js?mode=inline&color=%23d2ff3f&label=Book%20now"></script>

<!-- Mount points (mode=inline) -->
<div data-que-booking="your-slug"></div>

<!-- Popup trigger (mode=popup) -->
<button data-que-popup="your-slug">Book an appointment</button>

The three modes

ModeBehavior
inlineAutomatically mounts an iframe into any element with data-que-booking matching the slug (default)
popupExposes window.QueBooking.open(); attach to any element with data-que-popup matching the slug
floatingRenders a fixed bottom-right button that opens the booking popup

Parameters and validation

The script accepts color (branded button/widget color), label (call-to-action text), and prefill — a JSON-encoded parameter forwarded into the iframe so a host page can pre-select service or time context. The slug is validated against the published tenant before any JavaScript is emitted: an unknown or malformed slug returns a no-op response rather than an error page. Embedding runs inside an iframe, so the host page's styles cannot bleed into the booker and the booker cannot reach the host's DOM.

Same product, any surface

The embedded booker is the same public booking surface, not a reduced copy. Availability computation, forms, reminders, and payments behave identically whether the customer books on que.qubickle.com or inside your own site.

STILL READING

Something here still feels worth checking together.

This documentation describes the product exactly as it is implemented. If a behavior you expected is not here — or is here and does not match your deployment — tell the team. Implementation questions start on the contact page.