Edge

Assist

Widget & Embedding

The widget is a single dependency-free script. It can float as a launcher, live inline in a page, open from your own buttons or a keyboard shortcut — or you can skip integration entirely and link to the hosted page.

Floating Launcher (default)

<script src="https://assist.edge.network/widget.js"
  data-sitekey="ea_your_sitekey" defer></script>

With no other markup, the widget renders a launcher pill (position and label configurable in Control). Clicking it opens the assistant as a centered overlay; on mobile it fills the screen. The pill samples the page behind it and inverts to stay readable over dark sections.

Styles are isolated in a shadow root, so your CSS can't break the widget and the widget can't leak into your page. Typography follows your page's font family.

Script Tag Options

Attribute Meaning
data-sitekey Required. Your site's public key (ea_…).
data-hotkey Optional. A single key that opens the assistant in search mode with Cmd/Ctrl — e.g. data-hotkey="k" for ⌘K.
defer Recommended. The widget never blocks your page load either way.
<script src="https://assist.edge.network/widget.js"
  data-sitekey="ea_your_sitekey" data-hotkey="k" defer></script>

Your Own Triggers

Any element with data-edge-assist-open opens the assistant on click — a nav search icon, a "Chat with us" button on your contact page, a "Can't find it? Ask" link on your 404:

<!-- Any element becomes an open trigger -->
<button data-edge-assist-open>Chat with us</button>

<!-- Open in search mode instead of chat -->
<button data-edge-assist-open="search">Search the site</button>

Or drive it from JavaScript:

// Available once widget.js has loaded
window.EdgeAssist.open()          // open in chat mode
window.EdgeAssist.open('search')  // open in search mode
window.EdgeAssist.close()
window.EdgeAssist.toggle()

// Or fire an event (no reference to the API object needed)
window.dispatchEvent(new CustomEvent('edge-assist:open'))

Inline Embed

Give the widget a mount point and the panel renders in the page flow instead of floating — a persistent ask box for help centres, docs sidebars, and support pages:

<!-- The panel renders inside this element instead of floating -->
<div data-edge-assist></div>

<!-- Fill the container completely (used by the hosted page) -->
<div data-edge-assist data-mode="page"></div>

The inline panel and the overlay are the same assistant with the same conversation state. Size the container however you like; the panel fills it.

Hosted Page (zero integration)

Every site gets a full-page assistant at https://assist.edge.network/w/<sitekey> — link to it from an email signature, a social bio, or a support menu before you've touched your site's code. The exact URL is on your site's Overview page in Control.

Conversation Behaviour

  • Conversations are stored in the visitor's browser session and survive page navigations and close/reopen. They expire after 30 minutes idle or when the tab closes. "New conversation" ends a thread explicitly.
  • Follow-ups carry context: the assistant sees the recent turns, so "why?" and "how much?" work naturally.
  • Threads cap at 20 questions (100 with extended conversations) — long threads on a marketing or docs site are almost always a support case, which is what handoff is for.
  • If the visitor's question can't be answered from your content, Assist says so and — when a handoff email is configured — offers to bring in a human.

Customisation (Control → Widget)

Everything below is a setting, not code — changes apply to live widgets within minutes:

Setting What it does
Accent colour Brand colour for links, chips, and highlights.
Position Launcher corner: bottom-right or bottom-left.
Welcome message & placeholder The greeting and the input hint.
Suggested questions Up to four one-click chips shown before the first question.
Launcher prompts Labels the floating pill rotates through every few seconds.
Keep exploring links Curated links shown alongside citations in the expanded view.
Handoff email Enables "Need a human?" — conversations are forwarded here with the transcript.
White label & assistant name Paid: name the assistant after your product and remove the "Powered by Edge Assist" badge.
Extended conversations Paid: longer threads with deeper memory. Deep turns meter at 2× — see Limits & Billing.

Next Steps