Need to embed a reviews widget using plain HTML? Rated Stores' embed is a single line of HTML plus one <script> tag — works on any website, no build tools, no framework, no developer required.
The Full Embed Code
<div class="rated-stores-widget" data-settings='{"id":"your-id","type":"list"}'></div>
<script src="https://widgets.ratedstores.com/latest.js" defer></script>
That's it. Two lines. Paste anywhere HTML works.
What Each Part Does
<div class="rated-stores-widget">— placeholder where the widget rendersdata-settings— JSON config (your company ID + widget type + customisation)<script>— loads the widget bundle (sub-30KB, async-deferred)
The script loads once. Multiple widgets on the same page share the bundle.
Where It Works
- ✅ Shopify — Custom HTML section or theme.liquid
- ✅ Wix — Embed HTML element
- ✅ Squarespace — Code block
- ✅ WordPress — HTML block (Gutenberg) or Custom HTML widget
- ✅ Webflow — Embed element
- ✅ Ghost — HTML card
- ✅ BigCommerce — Custom HTML or theme template
- ✅ Custom HTML sites — paste anywhere in
<body> - ✅ Static site generators (Hugo, Jekyll, Next.js, etc.)
- ✅ Email signatures (with caveats — most email clients block scripts)
If your platform accepts HTML or <script> tags, our widget works.
How Shadow DOM Prevents CSS Conflicts
Most embeddable widgets either pollute your site's CSS or load slow iframes that break responsive layouts. Rated Stores uses Shadow DOM — modern browser-native style isolation.
What this means:
- ✅ Your site's CSS doesn't affect the widget
- ✅ The widget's CSS doesn't affect your site
- ✅ Layout shift (CLS) = 0
- ✅ Fonts and theme stay isolated
- ✅ No iframe — Google indexes the content as part of your page
This is the right architecture for embeds. Most competitors made the iframe choice years ago and can't reverse it.
Customisation
Use the dashboard live editor to customise, then copy the updated embed code with your settings baked into data-settings. Changes you can make:
- Colors (background, accent, star, text)
- Fonts (Google Fonts integration)
- Layout (max width, position for floating widgets)
- Source filters (which review sources to include)
- AI summary toggle (paid plans)
- Mobile/desktop preview before publishing
Multiple Widgets on One Page
Yes — embed as many as you want. Each <div class="rated-stores-widget"> with its own data-settings renders independently. Use a badge in the header, a list on the homepage, a carousel on product pages — all from one shared script.
<!-- Header badge -->
<div class="rated-stores-widget" data-settings='{"id":"your-id","type":"badge"}'></div>
<!-- Homepage list -->
<div class="rated-stores-widget" data-settings='{"id":"your-id","type":"list"}'></div>
<!-- Product page carousel -->
<div class="rated-stores-widget" data-settings='{"id":"your-id","type":"carousel"}'></div>
<!-- Single shared script -->
<script src="https://widgets.ratedstores.com/latest.js" defer></script>
Performance
- Bundle size: sub-30KB gzipped (vs Elfsight's ~150KB+ iframes per widget)
- Loading: async-deferred, doesn't block page render
- First paint: Shadow DOM renders synchronously once data arrives
- Caching: widget bundle CDN-cached globally via Cloudflare
- CLS: zero layout shift (reserved container)
Run a Lighthouse audit — the widget shouldn't move the needle on Core Web Vitals.
SEO
The HTML embed includes JSON-LD review schema injected directly into your page. Google reads it, indexes the reviews as part of your page, and shows star ratings in search results.
For ecommerce stores this typically produces double-digit CTR uplift in search — the highest-leverage SEO change available.
FAQ
Do I need a developer to install this? No — paste two lines of HTML anywhere on your site. Most platforms have a "Custom HTML" section that makes this 30-second work.
Will it slow my site down? No — sub-30KB bundle, async loaded, zero layout shift.
Can I use it offline? No — the widget fetches reviews from our API at render time. The script and data both require network access.
Will my embed break if you update the widget? No — latest.js is the stable URL; we ship updates without breaking the embed contract. Settings remain backwards-compatible.
Get Started
Sign up free → and get your embed code in 5 minutes.