Choose Your Integration Path
Two ways to add Returning.AI loyalty widgets to your platform.
No Backend
"I can only paste HTML"
Paste a widget loader script tag into any HTML page. Identify users via data-* attributes. Works with WordPress, Webflow, Squarespace, or plain HTML files. No JavaScript build required.
Get Started
Recommended
"I have backend access"
Access Key authentication with bundle mode rendering. Server-verified identity, native DOM integration, and the best performance. The recommended path for production integrations.
Get Started
Feature Comparison
A side-by-side comparison to help you pick the right approach.
| Feature | Widget SDK | Embed Script |
|---|---|---|
| Setup complexity | npm install or CDN script tag + backend endpoint for Access Key | Paste a script tag - no build step |
| Framework support | React, Vue, Angular, Svelte, plain HTML | Any - works in static HTML, CMS, no-code tools |
| Security model | Access Key Embed (server-issued embed token) or attribute auth | Attribute auth via data-* attributes |
| Rendering | Bundle mode (light DOM, native scrolling) or iframe fallback | Widget loader creates an iframe automatically |
| Customization | Full CSS cascade in bundle mode, CSS custom properties in iframe mode | Theme and dimensions via data-* attributes |
| Bundle size impact | ~15 KB gzipped (SDK script) | Zero - nothing added to your bundle |
| Best for | SPAs, modern web apps, logged-in portals, trader dashboards | CMS pages, static sites, WordPress, quick prototypes |
Not sure which to pick?
Start with the Widget SDK. If you don't have backend access, use the Embed Script.