For developers

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.

Request your key

Choose your website platform

Any website / HTML

Who it’s forHand-built sites, site builders with an HTML or code box, and web apps.
PlanAny — you just need to be able to edit the page’s HTML.
  1. Open the page’s HTML in your editor, or your site builder’s HTML / code view.
  2. 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.
  3. 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>
  4. 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.
  5. Save and publish the page.
Done — check it

Stuck? Use the No code (link & QR) tab instead — it works on every plan.

Simplified sketch — your editor will look a little different.

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

  1. Don’t change what the card shows. No hiding scores, no adding stars or counts.
  2. Ask everyone. Don’t show the button only to happy customers, and don’t offer anything in return for a rating.
  3. 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.