Vote badge
Embed the live "Ranked on MMOLove" vote badge — a self-updating SVG showing your hearts and rank, wrapped in an attributed backlink.
The vote badge is a small, self-updating SVG that shows your server's live
heart count and rank: ♥ 1,240 · #3 · MMOLove. Paste it on your website, forum, or
Discord for credible social proof. Every embed is a do-follow backlink and a
referral path back to your listing — the more people who see it, the more votes you
get.
The easiest way to grab the badge is the Embed your badge card on your server's dashboard (Integration tab): pick a theme, preview it live, and copy a ready-made snippet. This page documents the underlying endpoint if you want to build the embed by hand.
The endpoint
GET https://mmolove.com/badge/<serverId>.svg?theme=light|dark- Returns
image/svg+xml— embed it with a plain<img>(or Markdown image). - The
.svgsuffix is optional (/badge/<serverId>works too), but the snippet uses.svgso it reads cleanly as an image.
| Param | Values | Default | Meaning |
|---|---|---|---|
theme | light | dark | light | Colour scheme. Light = white card; dark = deep card for dark sites. Any other value falls back to light. |
Your serverId is the MMOLove server id — it's in your dashboard URL and on the
Integration tab.
Copy-paste embed
The badge is best wrapped in an attributed link so every click is counted and routed safely back to your listing. This is exactly what the dashboard snippet produces:
<a href="https://mmolove.com/out/<serverId>?k=website&src=badge" target="_blank" rel="noopener">
<img src="https://mmolove.com/badge/<serverId>.svg" alt="Ranked on MMOLove" height="40" />
</a>Dark theme — just add ?theme=dark to the image URL:
<a href="https://mmolove.com/out/<serverId>?k=website&src=badge" target="_blank" rel="noopener">
<img src="https://mmolove.com/badge/<serverId>.svg?theme=dark" alt="Ranked on MMOLove" height="40" />
</a>Markdown (e.g. a README or wiki) — image only, no attributed wrapper:
[](https://mmolove.com/out/<serverId>?k=website&src=badge)The /out/<serverId>?k=website&src=badge link is MMOLove's attribution redirector:
it resolves your server's own website by id (no open redirect) and records the click
as src=badge. Using it means badge traffic is tracked — but a plain link straight
to your listing works too.
What it shows
The badge renders, left to right: a heart glyph, this month's heart count, your
rank within your game (as a #3 chip — hidden if you're unranked), and the
MMOLove wordmark. It's a hand-built SVG with no external fonts or scripts, so it
renders identically in an <img> sandbox everywhere.
The data is the same ranked list as the public leaderboard, so the badge's rank always matches your listing.
Live + cached
The badge is live — it reflects your current hearts and rank — but it's CDN-cached for a few minutes, so embeds stay fast and don't hammer the origin. Expect changes to show within ~5 minutes, not instantly.
Published-only + graceful degrade
- The badge only renders for published listings. An unknown id, or a
pending/rejectedlisting, returns a404— pending/rejected servers never expose a public badge. - Even on a
404, the endpoint still returns a neutral "unavailable" chip SVG (cached briefly) rather than an error. So a broken or not-yet-published embed degrades to a tidy placeholder instead of a broken-image icon — it'll start showing real numbers the moment your listing goes live.
The backlink benefit
Each embed is a do-follow link back to MMOLove (and, via the attributed redirector, to your own site). That's the Product-Hunt-badge playbook applied to game servers: voluntary distribution, credible social proof, and a compounding referral + SEO path that lifts your rank as more players see it.