Embed Widget Overview

The Ilana embed widget is a pre-built chat interface that can be added to any website with a single <script> tag. It's the zero custom code path — authentication, conversation management, theming, and governance are all handled for you.

Don't want to build a custom UI? The embed widget is your fastest path to a governed AI chat experience. For partners who want full control over their frontend, see the SDK and React SDK for the BYOFE approach.

Two Ways to Integrate

Script Tag (Simplest)

Add a <script> tag with data attributes. The widget auto-initializes on page load:

<script
  src="https://cdn.getilana.ai/embed.js"
  data-bot-id="your-bot-id"
  data-token="your-embed-token"
></script>

See Script Tag Integration for the full attribute reference.

Programmatic (Full Control)

Load the script, then initialize manually with window.Ilana.init():

const widget = window.Ilana.init({
  botId: 'your-bot-id',
  token: 'your-embed-token',
  theme: {
    primaryColor: '#0ea5e9',
  },
});

widget.open();

See Programmatic API for the full method reference.

Features

• Floating action button (FAB) that opens a chat panel
• Multi-turn conversations with automatic context tracking
• Customizable theming — colors, fonts, dimensions, icons
• Suggested questions configured in the admin portal
• Template support for custom UI beyond the default chat
• Governance built in — all responses are governed by Capability Profiles and Personas

Embed vs BYOFE

Sections

• Script Tag — Data attribute reference
• Programmatic API — window.Ilana.init() and widget methods
• Theming — Customizing colors, fonts, and icons