Iframe Embed

Embed Returning.AI widgets with a standard <iframe> tag. No npm packages, no build step - works on any platform that renders HTML.

Embed with Authentication

Every widget needs to identify the user so it can display their rewards, points, and tier status. Choose an approach based on whether you have a backend available:

<iframe
  src="https://prod-widgets.returning.ai/store/YOUR_WIDGET_ID
    ?email=user@example.com
    &userId=USR-9a3f2b
    &firstname=Jane"
  allow="clipboard-write"
  frameborder="0"
  style="width: 100%; height: 600px; border: none;"
></iframe>

<iframe
  src="https://prod-widgets.returning.ai/store/YOUR_WIDGET_ID"
  id="returningAiWidgetIframe"
  allow="clipboard-write"
  frameborder="0"
  style="width: 100%; height: 600px; border: none;"
></iframe>

<script>
  // Listen for token requests from the widget
  window.addEventListener('message', (event) => {
    if (event.data.type === 'RETURNINGAI_WIDGET_REQUEST_TOKEN') {
      // Fetch token from your backend, then respond:
      event.source.postMessage(
        { type: 'RETURNINGAI_WIDGET_TOKEN', value: { token } },
        event.origin
      );
    }
  });
</script>

When to Use

The iframe embed works on any platform that supports HTML. No npm, no bundler, no framework required.

• WordPress, Shopify, Squarespace, or any CMS
• Static HTML sites
• Platforms where you cannot install npm packages
• Legacy applications with existing auth systems
• Email templates or webviews with limited JavaScript support

If you can install npm packages and use a modern framework, consider the Widget SDK instead for a tighter integration with Shadow DOM isolation and automatic token management.

Next Steps