
A widget is a small, self-contained piece of functionality that you can drop into any web page without having to build it yourself. Think of it like a pre-built appliance β you do not need to know how a microwave works on the inside; you just plug it in and use it.
On a web page, a widget typically appears as a button, panel, or small interactive element. The RateMe widget is a single block of HTML and JavaScript that you paste into your page once. Your visitor sees a styled button; clicking it takes them directly to your review page on the social platform of your choice.
Before placing the widget on your website you must first create and configure a Tag inside the RateMe portal. A Tag is the configuration record that tells the widget which social platform to link to, which domain it is allowed to run on, and how it should behave.
Log in to the RateMe portal and navigate to the Tags page. Navigate to your Tag.
The portal has assigned a UUID (Universally Unique Identifier) to the Tag β a long string of letters and numbers that looks like this:Example UUID
2ee2c984-90e4-447c-aae5-4adf2ef12b7c
Copy this UUID and keep it to hand β you will paste it into the widget snippet when you embed it into your page. Every Tag has a different UUID; using the wrong one will load the wrong configuration.
The Website field controls which domain is permitted to load this Tag:
| Setting | Effect |
|---|---|
| Left blank | Any web page on any domain can load this Tag. Useful during development and testing. |
| Your domain entered | Only requests coming from that exact domain are served. All other domains receive an JSON formatted error and the widget will not appear. |
β οΈ Warning: Wrong domain = silent failure If an incorrect domain is entered in the Website field the widget will receive a JSON error. Your visitors will not see an error message β the button simply will not work. Always double-check the domain after saving.
π‘ Tip: www vs non-www Many browsers automatically redirect a bare domain to its www equivalent. If your widget stops working on certain browsers, try entering www.example.com instead of example.com. To check which version your site uses, open it in Chrome and read the address bar after the page has loaded β use exactly what you see there.
The RateMe widget is a single, self-contained snippet. There is no external script file to load separately. Everything β the container, the link, and the styling β lives in one block of code that you paste into your page once.
The snippet has two parts working together:
<div> with the id rateme-widget-container β this is the placeholder that marks where the button will appear on your page.<script> that reads your UUID, builds a styled link pointing to https://rateme.club/r/{uuid}, and injects it into that container.Paste this entire block wherever you want the button to appear on your page. Replace the UUID value with your own.Complete widget snippet
<!-- RateMe Widget β paste where you want the button to appear -->
<div id="rateme-widget-container"></div>
<script>
(function() {
var uuid = '2ee2c984-90e4-447c-aae5-4adf2ef12b7c'; // β replace with your UUID
var container = document.getElementById('rateme-widget-container');
if (!container) return; // safety check β exits silently if div not found
container.innerHTML =
'<a href="https://rateme.club/r/' + uuid + '" ' +
'target="_blank" rel="noopener" ' +
'style="display:inline-flex;align-items:center;gap:8px;
padding:12px 22px;background:#FF6B35;color:#fff;
border-radius:8px;font-family:sans-serif;font-size:15px;
font-weight:600;text-decoration:none;border:none;cursor:pointer;">' +
'β Rate Us' +
'</a>';
}());
</script>
<!-- End RateMe Widget -->
Because the button is built by the script, all styling sits inside the style="..." string within the container.innerHTML assignment. You can change any of these values to match your siteβs design. The table below lists the key properties:
| Property | Default value | What it controls |
|---|---|---|
| background | #FF6B35 | Button background colour |
| color | #fff | Text and icon colour |
| padding | 12px 22px | Space inside the button |
| border-radius | 8px | Corner roundness (0 = square, 50px = pill) |
| font-size | 15px | Text size |
| font-weight | 600 | Text boldness |
| gap | 8px | Space between icon and text |
You can also change the button label β replace 'β Rate Us' with any text or emoji you prefer, for example 'π Leave a Review' or 'β Review Us on Google'.
Variation: dark pill style
<!-- RateMe Widget -->
<div id="rateme-widget-container"></div>
<script>
(function() {
var uuid = 'YOUR-UUID-HERE';
var container = document.getElementById('rateme-widget-container');
if (!container) return;
container.innerHTML =
'<a href="https://rateme.club/r/' + uuid + '" ' +
'target="_blank" rel="noopener" ' +
'style="display:inline-flex;align-items:center;gap:10px;
padding:14px 28px;background:#1F4E79;color:#fff;
border-radius:50px;font-family:sans-serif;font-size:15px;
font-weight:600;text-decoration:none;cursor:pointer;
box-shadow:0 4px 14px rgba(0,0,0,0.25);">' +
'β Leave a Review' +
'</a>';
}());
</script>
<!-- End RateMe Widget -->
To make the button float in a fixed position on screen (e.g. bottom-right corner), wrap the container in a positioned div:Variation: floating badge
<!-- Floating wrapper -->
<div style="position:fixed;bottom:20px;right:20px;z-index:9999;">
<div id="rateme-widget-container"></div>
</div>
<script>
(function() {
var uuid = 'YOUR-UUID-HERE';
var container = document.getElementById('rateme-widget-container');
if (!container) return;
container.innerHTML =
'<a href="https://rateme.club/r/' + uuid + '" ' +
'target="_blank" rel="noopener" ' +
'style="display:inline-flex;align-items:center;gap:8px;
padding:12px 22px;background:#FF6B35;color:#fff;
border-radius:50px;font-family:sans-serif;font-size:15px;
font-weight:600;text-decoration:none;cursor:pointer;
box-shadow:0 4px 14px rgba(0,0,0,0.3);">' +
'β Rate Us' +
'</a>';
}());
</script>
<!-- End RateMe Widget -->
π‘ The rule of thumb The only part of the snippet you must change is the UUID value. Everything else β the colours, text, size, shape, and position β is optional. As long as the container div has id="rateme-widget-container" and the UUID in the script matches your Tag, the widget will work.
When you configure your Tag with multiple social platforms, visitors who click the widget are shown a short ladder menu first.
If you configure your Tag with only one social platform (for example, Google), the ladder menu is skipped entirely. A single click on the button takes the visitor directly to your Google review page β no intermediate step, maximum conversions.
π‘ When to use a single-platform Tag When you only want to use one review or social site, you can always add others later to broaden your social media coverage. Every extra click reduces conversions, so going straight to the review site may makea small increase in the number of published reviews you receive.
When sending visitors directly to one platform, we recommend using that platformβs recognisable logo rather than a generic star. This immediately tells visitors where they are going. Two excellent free options are shown below.
Simple Icons provides SVG brand logos via a direct CDN URL. Replace the brand name in the URL to switch icons. No account, no library, no setup β just an <img> tag.Simple Icons β Google logo
<!-- RateMe Widget with Simple Icons Google logo -->
<div id="rateme-widget-container"></div>
<script>
(function() {
var uuid = 'YOUR-UUID-HERE';
var container = document.getElementById('rateme-widget-container');
if (!container) return;
container.innerHTML =
'<a href="https://rateme.club/r/' + uuid + '" ' +
'target="_blank" rel="noopener" ' +
'style="display:inline-flex;align-items:center;gap:10px;
padding:12px 22px;background:#ffffff;color:#333;
border:2px solid #e0e0e0;border-radius:8px;
font-family:sans-serif;font-size:15px;
font-weight:600;text-decoration:none;cursor:pointer;">' +
'<img src="https://cdn.simpleicons.org/google" width="22" height="22" alt="Google"/>' +
'Review us on Google' +
'</a>';
}());
</script>
<!-- End RateMe Widget -->
You can also tint the icon by appending a hex colour to the URL:Simple Icons β tinted colour
<!-- Google icon in Google-brand blue --> <img src="https://cdn.simpleicons.org/google/4285F4" width="22" height="22" alt="Google"/> <!-- Other platforms: swap the name in the URL --> <!-- cdn.simpleicons.org/facebook --> <!-- cdn.simpleicons.org/tripadvisor --> <!-- cdn.simpleicons.org/trustpilot --> <!-- cdn.simpleicons.org/yelp -->
Font Awesome is the most widely used icon library on the web. Add the stylesheet link to your page <head> once, then reference any icon with a simple <i> tag inside the widget HTML string.Step 1 β add to your <head> once
<link rel="stylesheet"
href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.7.2/css/all.min.css"/>
Step 2 β widget snippet with Font Awesome Google icon
<!-- RateMe Widget with Font Awesome Google icon -->
<div id="rateme-widget-container"></div>
<script>
(function() {
var uuid = 'YOUR-UUID-HERE';
var container = document.getElementById('rateme-widget-container');
if (!container) return;
container.innerHTML =
'<a href="https://rateme.club/r/' + uuid + '" ' +
'target="_blank" rel="noopener" ' +
'style="display:inline-flex;align-items:center;gap:10px;
padding:12px 22px;background:#4285F4;color:#fff;
border-radius:8px;font-family:sans-serif;font-size:15px;
font-weight:600;text-decoration:none;cursor:pointer;">' +
'<i class=\"fa-brands fa-google\" style=\"font-size:18px;\"></i>' +
'Review us on Google' +
'</a>';
}());
</script>
<!-- End RateMe Widget -->
Other Font Awesome social icons
<i class="fa-brands fa-google"></i> <!-- Google --> <i class="fa-brands fa-facebook"></i> <!-- Facebook --> <i class="fa-brands fa-tripadvisor"></i> <!-- TripAdvisor --> <i class="fa-brands fa-yelp"></i> <!-- Yelp --> <i class="fa-brands fa-trustpilot"></i> <!-- Trustpilot -->
π‘ Note: quote escaping inside the script string Because the icon tag sits inside a JavaScript string, any double quotes inside the HTML must be escaped as \". You can see this in the Font Awesome example above: class=\"fa-brands fa-google\".
example.com or www.example.com by checking the address bar in Chrome after the page loads.style="..." string inside the script to match your siteβs design β colours, padding, border-radius, and button text are all yours to change.Β© RateMe β RateMe Widget Implementation Guide
Leave a Reply
You must be logged in to post a comment.