Review Widget Integration Guide

Embed your Your.Reviews rating and reviews on any website with a single script tag.

1. Create a widget

In your dashboard, open Widgets for your business, choose a type, customise the appearance, and copy the embed snippet shown on the widget’s page. It already contains your embed token — the snippet below is the same thing with the token blanked out.

2. Paste the embed code

Paste it where you want the widget to appear. There is no separate placeholder element: the script inserts the widget directly after itself, so its position on the page is the widget’s position.

<!-- Paste this where the widget should appear. -->
<script
  src="https://backend-api.your.reviews/embed.js"
  data-token="YOUR_EMBED_TOKEN"
  data-size="md"
  async
></script>

The script is asynchronous and self-contained — it will not block your page or pull in extra dependencies. To show more than one widget, paste the snippet once per widget, each with its own token, in the place that widget should appear.

Options

data-tokenrequired

The embed token from your widget’s page in the dashboard. Without it nothing renders.

data-sizesm · md · lg

Overall scale. Defaults to lg.

data-scale0 – 2

Exact scale factor, if the presets do not fit. Overrides data-size.

data-lazytrue · false

Defer loading until the widget scrolls into view. Defaults to true.

data-debugtrue · false

Log what the embed is doing to the browser console.

If nothing appears

Check the snippet still has its data-token. Without it the script loads and renders nothing, deliberately quietly, so a copy-paste error cannot break your page.
Add data-debug="true" to the tag and open your browser console — the embed will explain what it is doing.

Widget types

Badge BADGE

Compact trust badge with your average rating and review count.

Carousel CAROUSEL

Scrollable row of recent review cards.

Grid GRID

Responsive grid of review cards.

Wall WALL

Full-width masonry-style wall of reviews.

Floating button FLOATING_BUTTON

A pill that pins to the corner and links to your reviews.

Snackbar SNACKBAR

Slim rating bar for headers, footers, or product pages.

Notes

Embed tokens are signed and scoped to one widget on your business; the token in the snippet is safe to make public.
Light and dark themes are available in the widget appearance settings.
The widget updates automatically as new reviews come in — no code changes needed.

Need help? Contact us or visit the Help Center.