Your.Reviews·Widgets

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

Attribute	Values	What it does
`data-token`	required	The embed token from your widget’s page in the dashboard. Without it nothing renders.
`data-size`	xs · sm · md · lg · xl	Overall scale. Defaults to lg.
`data-scale`	0 – 2	Exact scale factor, if the presets do not fit. Overrides data-size.
`data-lazy`	true · false	Defer loading until the widget scrolls into view. Defaults to true.
`data-debug`	true · 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

Type	What it shows	Plan
Badge	Compact trust badge with your average rating and review count.	Free and up
Carousel	Scrollable row of recent review cards.	Growth and up
Grid	Responsive grid of review cards.	Growth and up
Wall	Full-width wall of review cards.	Pro
Floating button	A pill that pins to the corner and links to your reviews.	Pro
Snackbar	Slim rating bar for headers, footers or product pages.	Pro

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 .

Free includes the badge; Growth adds the carousel and grid; Pro has every type.

About

Community

Businesses

Contact

Every plan includes a widget

Free includes the badge; Growth adds the carousel and grid; Pro has every type.

Add your business See the plans