Add Your Assistant to Your Website
When it works in the sandbox, going live is mostly copy-paste. The display mode you picked in the wizard is exactly how it will look on your page — you're not rebuilding anything, just placing it.
Before You Start
- Allowed origins — add your site's address to the assistant's allowed-origins list, so your page is permitted to load it. Until you do, the assistant refuses to start on that domain.
- Access key — if the security mode is API, copy the key from the assistant's Keys tab. A None-mode (public) assistant needs no key.
- Assistant ID — you'll paste this into the snippet. It's on the assistant's page.
Drop In the Snippet
Add three things to your page: the Seekdown runtime script, a container element, and a short init snippet. This is the exact shape the product generates — swap in your own assistantId (and accessToken if your assistant needs one):
<div id="seekdown-assistant-root"></div>
<!-- Include the public Seekdown runtime -->
<script src="https://saas.seekdown.ai/js/seekdown-assistant.js"></script>
<!-- Initialize the assistant with your assistantId and accessToken -->
<script>
document.addEventListener('DOMContentLoaded', function () {
if (window.skdwn?.startAssistant) {
let seekdownAssistantOptions = {
assistantId: 'your-assistant-id',
accessToken: 'your-api-key-or-identity-access-token',
};
skdwn.startAssistant(seekdownAssistantOptions);
} else {
console.error('skdwn.startAssistant is not available.');
}
});
</script>The access token is optional
Include accessToken only when the security mode is API (an assistant key) or OIDC (your provider's token). A None-mode assistant starts with just assistantId.
On a Platform Instead of Plain HTML?
You don't always need to touch code. There's a short, dedicated guide for each of the common platforms:
- WordPress — install the official Seekdown plugin, paste your assistant ID, and show it site-wide or with a
[seekdown]shortcode. See Embed an Assistant in WordPress. - Shopify — add the same three snippets to your theme's
theme.liquid, just before</body>. See Embed an Assistant in Shopify. - ChatGPT (Custom GPT) — connect your assistant as an Action so a Custom GPT can answer from your content. See Create a Custom GPT Action.
Verify It's Live
Open the page (outside any admin area) and confirm the assistant appears and answers. If it doesn't, the usual culprits are a missing allowed origin, a wrong assistant ID, or a token the assistant expected but didn't get — the browser console will usually tell you which.