$ cat /the-headless-index/embed

Embed Your Scorecard

If your product is scored in The Headless Index, you can publish your band and score on your website, README, or marketing page. Every embed is a live image: when we re-score, the badge updates automatically. Every embed links back to the canonical scorecard.

// Live previews on this page use Stripe as the example. For your own copy-paste snippets, open the embed page on your scorecard.

01 / Mini badge

Mini badge — for READMEs

A shields.io-style strip: label, band letter, and score. Renders in markdown img tags, so it drops straight into any GitHub README, docs site, or static blog. About 150 × 28 px.

Markdown

[![Stripe — Headless Index](https://headless-systems.com/embed/payments/stripe/badge)](https://headless-systems.com/the-headless-index/payments/stripe)

02 / Card

Card — for footers and sidebars

Vendor name, the band letter at full size, both score totals, and a verified date. 320 × 120 px. Use it in a website footer, an About page, or anywhere a static badge isn't enough.

HTML

<a href="https://headless-systems.com/the-headless-index/payments/stripe">
  <img src="https://headless-systems.com/embed/payments/stripe/card" alt="Stripe — Headless Index Scorecard" width="320" height="120" />
</a>

03 / Full widget

Full widget — for marketing pages

All five Headless Index sub-scores, all six JAIRF dimensions, the band, and a deep link back to the full scorecard. Iframe-based, so it stays current automatically. About 480 × 420 px, resize freely.

HTML / iframe

<iframe src="https://headless-systems.com/embed/payments/stripe/widget" width="480" height="420" frameborder="0" loading="lazy" title="Stripe — Headless Index Scorecard"></iframe>

How to get your own

Generate snippets for your scorecard

Every public scorecard has a dedicated embed page with copy-paste snippets pre-filled for that vendor. Open your scorecard, then add/embedto the URL, or follow the link below.

See an example →Find your scorecard

Does the badge update when my score changes?

Yes. The SVG is rebuilt from the live scorecard data and cached for one day at the edge. Re-scores propagate within 24 hours.

Can I use the badge if my score is low?

You can embed any public scorecard regardless of band. We don't gate embeds by tier — the badge is honest by design.

Does the link have to be dofollow?

We don't require a specific rel attribute. The default snippets are dofollow because that's what most vendors want. You can wrap or strip as you see fit.

Light theme?

Append ?theme=light to the SVG or widget URL for a light-background variant.