Docs Badge
The badge
The badge is a small image that shows your site's latest scorebadge score and links to your public score page.
How it works
The badge is an SVG image served from https://scorebadge.com/badge/<your domain>.svg. It always shows the score from the most recent check of your site, so it updates by itself after every new check. Browsers may keep a copy for up to 5 minutes.
The colour follows the score: green at 90 and above, amber from 50 to 89, red below 50. A site that has never been checked shows "not scanned".
Get the code
Check your site, then scroll to "Add your badge" at the bottom of your report. Pick a style and click Copy badge code. The code looks like this:
If you use the Claude connector, you can also ask Claude for your badge code.
Styles and options
Add these to the end of the image address, for example /badge/example.com.svg?style=card&theme=dark. The style picker in your report writes them for you.
style:cardfor a larger card with a ring and a grade,pillfor a small round badge. Leave it out for the standard badge.metric:aishows the AI readiness score with the label "AI ready",securityshows the Security score. Leave it out for the overall score.theme:darkorlight. Works with every style.
The standard and pill badges are 22 pixels high, the card is 38.
Where to paste it
Most sites put it in the footer, so it shows on every page. Paste the code where your platform lets you add HTML to the footer:
A Custom HTML block in a footer widget area, or the footer template part in the site editor.
A Custom Liquid section in the footer, under Online Store, Themes, Customize.
An embed or code block placed in the footer.
The footer component or layout file that every page uses.
Questions
My badge shows an old score
The badge shows the latest check. Run a new check from the homepage, then reload the page after a few minutes.
Does the badge slow my site down?
It is one small SVG image. It loads like any other image and runs no scripts.
Free, about 30 seconds, with every other check included.