Skip to main content
This reference covers the direct iframe embed and its limits. Use it only when your page cannot run third-party scripts. For every other case, use the script embed.
Side by side comparison of what the script embed provides and what the direct iframe embed leaves out for the same agent.

​
The iframe tag

Copy the snippet from Distribute → Widget Embed, under the Iframe tab.
A ?lang= parameter on the iframe src sets the conversation locale. Only the /chat and /widget paths on the chat host allow framing from any site. The /preview path can be framed only by the chat host itself and the Tars dashboard. Every other path on the chat host refuses to load inside an iframe. See Framing rules.

​
What the iframe method cannot do

The iframe bypasses embed.js, so everything the script provides is unavailable. Signed identity cannot be attached with this method. End users start anonymous and can verify only through an OTP step inside the conversation.

​
When the iframe is the right choice

Choose the iframe when the host platform strips script tags. It also fits when the conversation should sit inline in the page layout rather than float as a widget.