Widget Types

Returning.AI provides six widget types, each designed for a specific aspect of the loyalty experience. Every widget can be embedded using the SDK or an iframe.

Available Types

Store

Rewards marketplace where users spend loyalty currency on products, vouchers, and experiences.

store

SDK tag	`<rai-widget>`
Iframe URL	`https://prod-widgets.returning.ai/store/{widget_id}`

Channel

Community hub with missions, quests, social tasks, and engagement activities.

channel

SDK tag	`<rai-channel-widget>`
Iframe URL	`https://prod-widgets.returning.ai/channel/{widget_id}`

Milestone

Progress tracker showing achievement stages and unlock rewards.

milestone

SDK tag	`<rai-milestone-widget>`
Iframe URL	`https://prod-widgets.returning.ai/milestone/{widget_id}`

Currency

Loyalty points display showing balance, transaction history, and earning opportunities.

currency

SDK tag	`<rai-currency-widget>`
Iframe URL	`https://prod-widgets.returning.ai/currency/{widget_id}`

Mini Games

Interactive games like spin-the-wheel and scratch cards for engagement.

minigames

SDK tag	`<rai-minigames-widget>`
Iframe URL	`https://prod-widgets.returning.ai/minigames/{widget_id}`

Customization

Every widget type supports theming and customization. You can control the visual appearance using the theme attribute, locale via the locale attribute, and dimensions with width and height.

example.html

<!-- SDK: themed dark with custom dimensions -->
<rai-channel-widget
  widget-id="YOUR_WIDGET_ID"
  theme="dark"
  width="100%"
  height="700px"
  locale="en"
  api-url="YOUR_API_URL"
  widget-url="YOUR_WIDGET_URL"
></rai-channel-widget>

<!-- Iframe: append ?theme=dark to the URL -->
<iframe
  src="https://prod-widgets.returning.ai/channel/YOUR_WIDGET_ID?theme=dark"
  style="width: 100%; height: 700px; border: none;"
></iframe>

SDK tag	`<rai-social-widget>`
Iframe URL	`https://prod-widgets.returning.ai/social/{widget_id}`