Embedding a Standalone Agent with an iframe

Last updated: August 11, 2026

Use an iframe when you want to place the standalone Marketing Agent experience inside a page that supports embedded content.

Before You Start

  • Copy the standalone page URL from the agent's Deploy tab.

  • Confirm the destination page allows iframe embeds.

  • Confirm the domain and access rules allow the intended visitors.

Example iframe

<iframe
  src="https://aiseller.app.docketai.com/YOUR_AGENT_PATH"
  title="Docket Marketing Agent"
  width="100%"
  height="720"
  style="border: 0;"
  allow="microphone"
></iframe>

Update the src value with your standalone page URL.

What to Validate

  • The iframe loads on the intended page.

  • The height is large enough for the conversation experience.

  • Microphone permissions work if the agent uses voice.

  • IP access rules do not block expected visitors.

  • The embedded page works on mobile and desktop.

Verify the iframe Embed

  1. Use the generated Embedding Code from the current agent's Deploy tab.

  2. Load the parent page in a private browser window.

  3. Confirm the standalone agent is visible at desktop and mobile widths.

  4. Complete a short text interaction and test microphone permission when required.

  5. Confirm the iframe loads only on the intended pages.

Troubleshooting the iframe

Problem

What to check

iframe is blank

Confirm the generated code was copied completely and review the parent page's Content Security Policy.

Microphone does not work

Confirm the parent page uses HTTPS and the generated iframe permissions were not removed.

Layout is clipped

Give the iframe container an explicit responsive width and height.

Wrong agent appears

Copy the embedding code again from the intended agent.

Related Articles