Aimdoc

Deploy

The Deploy tab is where you control visibility, copy install code, and publish your agent so visitors can use it on your site.

Configure how the widget looks in Appearance, and validate changes in Testing before you go live.

Visibility

Use the visibility toggles to control where the published agent is available:

  • Website visibility: Enable or disable the agent on your website.
  • Mobile visibility: Show or hide the agent for visitors on mobile devices.

Visibility changes are draft until you Publish.

Widget embed

Copy the installation snippet for your stack from the Deploy tab:

  • Static — For Framer, Wix, Webflow, Squarespace, or plain HTML. Paste the script before the closing </body> tag.
  • Next.js — Add the snippet to your layout.tsx (App Router).
  • React — Use @aimdoc/sdk-react with AimdocProvider and your agent ID.

Replace the agentId with your agent's ID if you are adapting the snippet manually.

For the most reliable install, add the Aimdoc script directly in your site or app code. Google Tag Manager can work, but privacy tools and ad blockers may block GTM or other third-party tags before the widget loads.

Example static embed:

<script>
(function() {
    function initAgent() {
        window.aimdoc.initAgentChat('ai-assistant', {
            agentId: 'YOUR_AGENT_ID'
        });
    }
    var script = document.createElement('script');
    script.src = 'https://app.aimdoc.ai/embedded.bundle.js';
    script.async = true;
    script.onload = initAgent;
    document.body.appendChild(script);
})();
</script>

For SDK-based installs (identify users, open chat programmatically, and more), see SDKs.

Iframe embed

Use the iframe snippet when you want the agent embedded inside a specific page or layout, rather than as the floating site widget:

<iframe
  src="https://widget.aimdoc.ai/agent/YOUR_AGENT_ID"
  width="100%"
  style="height: 100%"
></iframe>

Copy the ready-made iframe snippet from the Deploy tab so the URL matches your environment.

Publishing

Changes in the builder are saved as a draft. Click Publish to make them live for website visitors.

When you publish, Aimdoc opens a review of what changed between draft and live — grouped by section (Prompting, Configuration, Appearance, Data Capture, Workflow, Skills, Actions, Voice, Knowledge, App Mode, and more).

Test in Draft first, then publish and verify Live behavior if you need CRM sync or notifications. See Testing.

Selective publish

You do not have to ship every draft change at once. In the publish review:

  1. Review the listed changes by section.
  2. Leave selected the changes you want to go live.
  3. Deselect anything that should stay in draft.
  4. Publish.

Aimdoc merges only the selected paths onto the live agent and leaves deselected draft edits unpublished. If a partial selection would leave the live agent in an invalid state (for example, a tool that depends on another deselected change), publish is blocked until you adjust the selection.

Every publish is recorded in an append-only version history for the agent so you retain a snapshot of what went live.

Was this page helpful?