Website and marketing
Put a demo on a website
Create an embed, hand the snippet to your site builder or coding agent, and allow the domain.
Video walkthrough
How to add an embed to your website
3:11 · recorded October 2026Create an embed, copy the prompt for your coding agent, and add your website's domain to Allowed domains so the demo shows up.
What looks different now
- Embeds moved under Developers. The Embeds tab is still at the same address.
An embed puts one of your live demos inside any website: your own, or a client's. Visitors can call the AI receptionist or chat with the AI agent without leaving the page. It runs the same demo you built, with your brand and nothing of Lumina's.
Embeds live under Developers → Embeds at app.luminasales.io/embeds.
Before you start
- You need a claimed subdomain. Set it on the Brand page. See Brand, subdomain and custom domains.
- You need manage access to demos. Team members without it see "You need manage access to demos to change embeds."
- Your plan includes 3 embeds. To make a fourth, delete one or point an existing embed at a different demo.
- The demo behind an embed does not have to be published. A draft works.
Create an embed
- Go to Developers → Embeds.
- In the New embed card, fill in:
- Name: only you see it. For example "Riverside Dental homepage".
- Demo: pick New — receptionist + chat to build a fresh two-part demo, or pick one of your saved demos. Published demos show "(live)" after the name.
- Vertical: only shown for the new receptionist + chat demo. Pick the niche the agent should answer as.
- Layout: Inline sits inside the page. Bubble is a floating button in the corner.
- Press Create.
You will see "Created … Add the domain it goes on and it will start rendering." A new embed allows no domains, so it shows nothing anywhere until you add one. That is the next step.
Allow your website's domain
This is the step most people miss. If the domain is not on the list, the demo does not show up on that site.
- On the embed's card, find Allowed domains.
- Type each domain on its own line. You can list up to 8.
- Press Save.
Rules for the list:
| You type | What it allows |
|---|---|
acme.com | https://acme.com only |
www.acme.com | https://www.acme.com only. List both if your site uses both. |
*.acme.com | Any subdomain of acme.com, but not acme.com itself. List both if you need both. |
http://localhost:3000 | Your developer's local machine |
- A plain domain is read as
https://. Typehttp://yourself only when you mean it. - Paths and query strings are dropped.
acme.com/contactis the same asacme.com. *and*.comare refused.- A new domain can take about a minute to start working.
Allow any domain
If the domain list cannot cover where the embed goes (for example a preview link that changes on every deploy), use Allow any domain. The demo then renders on any website. Anyone who finds the snippet could put it on their own site, so your budgets are the only limit on what that costs. Press Use the domain list to switch back.
Install it on the website
The install panel on the card has three tabs. Each has a Copy button.
- Snippet: recommended. It sizes itself.
- Plain iframe: for site builders that will not accept a script tag. Fixed height, no auto-resize. Bubbles have no plain iframe version.
- For a coding agent: a ready prompt for Claude, Cursor, Lovable, Base44 or any AI site builder. It tells the agent where to paste the code and the rules it must follow.
If someone else built the website, send them the snippet and the embed install guide. If you built it with AI, paste the For a coding agent prompt into your builder.
The embed key (it starts with emb_) is not a secret. It is safe in your website's code.
Settings
Below the install panel:
- Name: only you see it.
- Layout: Inline — sits in the page or Bubble — floating launcher.
- Theme: Match the visitor's system (default), Always light, or Always dark.
- Button text (bubble only): up to 40 characters. Default "Try our AI".
- Max width (px) (inline only): 280 to 1400. Leave blank to fill the space.
- Voice minutes and Chat messages: a lifetime cap for this embed. Blank means no cap.
- Calls per visitor/day (default 2) and Messages per visitor/day (default 20).
- Live: untick to switch the embed off without deleting it.
- Show the behind-the-scenes panel (inline only, off by default).
- Transparent background (inline only, on by default). Untick it for a rounded box in the demo's own colour.
Rotate key or delete
- Rotate key gives the embed a new key. Every site with the old snippet stops showing the demo until it is updated with the new one.
- Delete cannot be undone. Every install goes blank.
What it uses from your plan
Embeds run on your plan's usage. Calls use voice minutes and chats use chat messages. A call or message has to fit under every limit at once: your monthly plan, the demo's own budget, the embed's budget, and the per-visitor daily limit. See Usage and limits.
When a limit is hit, the rest of the demo keeps working and the visitor sees a neutral message, such as "The live call is paused on this demo right now." Lumina is never named.
Check that it is working
Each embed card shows:
- A badge: Live, No domains yet, or Switched off.
- Views, calls and messages.
- Loading on: the pages it has loaded on most.
- A warning if a site tried to load it but was not allowed: "This embed is installed somewhere it is not allowed" or "Some pages were refused." Add the domain you recognise and the demo appears there.
If something goes wrong
The demo never shows an error on your website. When something is off, the space just stays empty. Work through Troubleshooting: Embeds. Developers can find the snippet options and events in the embed install guide and the Embed JavaScript API.
Still stuck? Ask Lumina Assistant in your dashboard (⌘J on any page), or read how to get help.
