Guide
Embed the widget
In a few minutes your assistant is live on any website — one line of code, securely allow-listed to your domains.
1. Copy the snippet
In Studio, open your assistant’s Deploy section. There you’ll find a one-line <script> snippet. Copy it and paste it once into your website’s HTML — ideally just before the closing </body> tag. That’s all it takes: the launcher button appears automatically, and the assistant loads asynchronously without slowing your page down.
<script async src="https://kyros.omniratio.de/embed.js" data-kyros="YOUR-ASSISTANT-CODE"></script>The snippet works on any CMS and any framework — WordPress, Shopify, Webflow, Wix, static HTML or a React/Next.js app. See the platform-specific guides if you want to know exactly where the code belongs.
2. Restrictive environments: the <iframe>
Some site builders or tightly locked-down pages won’t allow a custom script. For those cases Kyros also provides an <iframe> embed code. It renders the same assistant in an isolated frame — with no access to the surrounding page code.
<iframe src="https://kyros.omniratio.de/embed/widget/YOUR-ASSISTANT-CODE" width="100%" height="640" style="border:0"></iframe>3. Allow-list your domains
Before the widget goes public, set Allowed Domains to control which sites may embed it. That way nobody can run your assistant on a page that isn’t yours. Wildcard subdomains are supported — a single entry like *.your-domain.com covers staging, shop and blog at once.
4. Signed, expiring embed codes
Every embed uses a signed, expiring code. It’s issued server-side and refreshed on a schedule — so a snippet that leaks can’t be abused indefinitely. Combined with domain allow-listing, you stay in control of where and how long your assistant is reachable.
5. Go live and adjust
Once the snippet is on your page, the assistant is live. You keep editing branding, conversation starters and position in Studio — without touching the code again. See the chat widget page for the widget itself; for programmatic access, continue to the API reference.