DOCUMENTATION

Ship badges without touching code.

One snippet on your homepage template, one dashboard, live in seconds. Bots read real anchors.

3 steps±5 minutesno redeploys

01Install the snippet

Create a site in the dashboard, then fetch its fragment server-side so crawlers read real anchors with no JavaScript. All embeds are homepage-only.

Next.js — Server Component

app/page.tsx
async function Badges() {
  const html = await fetch("https://badgeroll.com/e/abc123.html").then((r) => r.text());
  return <div dangerouslySetInnerHTML={{ __html: html }} />;
}

Astro — frontmatter

src/pages/index.astro
---
const html = await fetch("https://badgeroll.com/e/abc123.html").then((r) => r.text());
---
<div set:html={html} />

WordPress — front-page.php

front-page.php
<?php
$res = wp_remote_get("https://badgeroll.com/e/abc123.html");
if (!is_wp_error($res)) echo wp_kses_post(wp_remote_retrieve_body($res)); ?>

Notewp_kses_post strips the carousel marquee animation. For an animated carousel in WordPress, use a Custom HTML block with the static snippet instead.

Static HTML — loader script

index.html
<!-- Homepage only -->
<div data-br="abc123"></div>
<script src="https://badgeroll.com/e/abc123.js" defer></script>

Heads upSecond choice for SEO: links appear after the loader runs. Prefer server-side fetch when the platform allows it.

02Add badges, then publish

Paste a directory's badge HTML into the dashboard, or enter label, link, and image manually. Arrange the order, switch badges off without deleting them, keep unfinished ones as drafts. Badges stay drafts until you hit Publish — then every page using the snippet reflects them within seconds.

03Verify like a bot

The dashboard homepage checker fetches your site the way a verification bot would and reports which badges it can see — the marker snippet plus each backlink — before a directory ever complains. Carousel layouts loop as a marquee; row layouts stay a static row. Listing watches check your badge link daily; when it misses, the bot also scans the directory sitemap to find your exact listing page.

04Plans

PlanQuotaDetails
Free $01 site · 10 badgesFull publish flow. Attribution line included.
Pro $10/mo · $100/yr5 sites · 500 badgesAttribution removed. Directory list, Telegram watches, DR tracking. Cancel anytime.

05FAQ

How bots read badges, why updates never need a deploy, what Pro includes, how payment works, and why hardcoding stops working at directory five — answered in full on the homepage FAQ.

Badgeroll is one snippet, one dashboard, publish in seconds — free for 1 site, Pro from $10/month.