Install the “Rate this tool” button
Pick your website platform below and follow the short steps. It takes a few minutes, and nothing else on your page changes.
The snippets below show your-tool and r8pk_your_key. Your approval email has a link to this page with your own details already filled in.
Choose your website platform
Any website / HTML
- Open the page’s HTML in your editor, or your site builder’s HTML / code view.
- Find the spot where the button should sit.A toolbar, beside the title, near your download button, or the row of links in your footer.
- Copy the two lines.
<div data-r8rly-tool="your-tool" data-r8-key="r8pk_your_key"></div> <script src="https://r8rly.com/embed/r8-widget.js" async></script>
- Paste them at that spot.Several tools on one page? Give each its own first line, and keep just one copy of the second line.
- Save and publish the page.
Stuck? Use the No code (link & QR) tab instead — it works on every plan.
WordPress & WooCommerce
A page or post
- Open the page: in your dashboard go to Pages → All Pages and click the page’s title.
- Click where the button should sit, then click the + (Add block) button.
- Type “Custom HTML” in the search box and click the Custom HTML block.
- Copy the two lines.
<div data-r8rly-tool="your-tool" data-r8-key="r8pk_your_key"></div> <script src="https://r8rly.com/embed/r8-widget.js" async></script>
- Paste them into the Custom HTML block.
- Click Update (or Save / Publish) at the top right.
A WooCommerce product page
- Go to Products → All Products and click Edit under the product.
- In the product description, pick how it’s shown:Block editor: click +, add a Custom HTML block. Classic box: click the Text tab (not Visual) — the Visual tab would turn the code into plain text.
- Paste the same two lines where the button should appear.
- Click Update.
Stuck? Use the No code (link & QR) tab instead — it works on every plan.
Shopify
- In your Shopify admin, go to Online Store → Themes.
- Click Customize next to your current theme.
- Pick the page from the page menu at the top (for example Home page, or Products → Default product).
- In the left sidebar, click Add section where the button should go.To sit inside an existing section instead, click Add block in that section.
- Choose Custom Liquid.
- Copy the two lines.
<div data-r8rly-tool="your-tool" data-r8-key="r8pk_your_key"></div> <script src="https://r8rly.com/embed/r8-widget.js" async></script>
- Paste them into the Liquid code box on the right.
- Click Save (top right).
No Custom Liquid option? Older themes may not have it — use the No-code tab, or ask whoever looks after your theme to paste the two lines into the template.
Stuck? Use the No code (link & QR) tab instead — it works on every plan.
Squarespace
- Open the page and click Edit (top left).
- Click Add Block where the button should sit.
- Choose Code from the list (type “Code” to find it).
- Copy the two lines.
<div data-r8rly-tool="your-tool" data-r8-key="r8pk_your_key"></div> <script src="https://r8rly.com/embed/r8-widget.js" async></script>
- Click into the Code block and paste them over the sample text.Leave Display Source switched off.
- Click Save (top left).
While you’re editing, Squarespace may show “Script disabled” in the block — that’s normal. The button appears on the live page.
Stuck? Use the No code (link & QR) tab instead — it works on every plan.
Wix
Recommended: Custom Code Easiest
Adds a small button in the bottom-right corner of the pages you choose.
- Open your site’s dashboard and click Settings.
- Scroll to Development & integrations and click Custom Code.
- Click + Add Custom Code (top right).
- Copy the Wix lines.
<div data-r8rly-tool="your-tool" data-r8-key="r8pk_your_key" style="position:fixed;right:16px;bottom:16px;z-index:50"></div> <script src="https://r8rly.com/embed/r8-widget.js" async></script>
- Paste them into the code box.
- Name it “R8rly button”.
- Under Add Code to Pages, choose Choose specific pages and tick the page(s) — or choose All pages.
- Under Place Code in, choose Body – end.
- Click Apply.
Your connected domain (with or without www.) needs to be on your key — it is if you gave it when you asked for the key.
Or: an Embed HTML box Exact spot
- Open the Editor on the page you want.
- Click Add Elements (the + on the left).
- Click Embed Code → Popular Embeds → Embed HTML.
- Click Enter Code on the new box.
- Copy the two lines.
<div data-r8rly-tool="your-tool" data-r8-key="r8pk_your_key"></div> <script src="https://r8rly.com/embed/r8-widget.js" async></script>
- Paste them under Add your code here, then click Apply.
- Drag the box’s corner until it’s about 260 × 360 pixels.The rating card opens inside the box, so it needs that room.
- Click Publish.
Inside the box, the button follows each visitor’s own light or dark setting. To always show one look, add data-theme="dark" (or "light") to the first line.
Stuck? Use the No code (link & QR) tab instead — it works on every plan.
No code: a link and a QR code
Your rating link
- Copy your rating link (above).
- Add it as a text link or button that says “Rate us on R8rly”.
- For print, download the QR code below — PNG for most uses, SVG for printers and designers.
- Place the QR with the short link and a label right beside it.
- Test-scan it with a phone before you print.
Your QR code
Light version — for white or pale backgrounds
Dark version — for dark designs
Alt text for the QR image
Paste this into the image’s “alt text” or “description” box on websites and in emails.
Text link to put beside it
- Never a QR on its own. Always put the short link and a plain label with it — “Rate us on R8rly — r8rly.com/…” — so people without a camera, with low vision, using a screen reader or an older phone can still rate.
- On websites and in emails, give the QR image the alt text above, and make the image itself a link to the same address.
- On screens, the QR is extra. Keep the button or the text link there too, since nobody can scan the screen they’re reading on.
- In print: at least 2 cm (0.8 in) wide for close-up scanning, bigger for posters read from a distance; keep the white margin around it; dark squares on a light background; matte paper if you can; and test-scan before you print.
- The dark version keeps the code on its own white tile — don’t recolour or remove the tile, and use it only where that tile stands out clearly.
Light and dark mode
The button follows your page’s own light/dark switch automatically. To force one look, add data-theme="light" or data-theme="dark" to the first line. Developers can also call window.R8rly.setTheme('light' | 'dark' | 'auto'), or point at their own toggle with data-theme-from="#themeToggle|aria-pressed". Inside an embed box (like Wix’s), it follows the visitor’s system setting.
If the card says “This rating form isn’t set up for this site.”
The page’s address isn’t one approved for your key (check https:// and www.), or the tool isn’t on your key. Reply to your approval email and R8rly will add it.
Rules to keep
- Don’t change what the card shows. No hiding scores, no adding stars or counts.
- Ask everyone. Don’t show the button only to happy customers, and don’t offer anything in return for a rating.
- Keep it small. A pill or a link, never a big block.
Need a key? Request one here. Building your own design instead? See the API.