Documentation

The badge validator

A free tool that checks a badge against the specification, in your browser.

There is a free validator on the marketing site at /tools/badge-validator.

Drop in a baked PNG or SVG, paste the address of a hosted badge, or upload the credential document. It reports, field by field, what is missing or wrong — for both 2.0 and 3.0 — and supports ?url= deep links so a page about a badge can link straight to its report.

Nothing is uploaded. It runs entirely in your browser. A badge is a document about a named person, often with their email address hashed into it, and a tool that quietly posted the file to a server would be a worse privacy failure than the problem it solves.

What it does not do

It does not verify the cryptographic signature on a 3.0 credential. Doing that in a browser means resolving the issuer's DID document cross-origin, and most issuers do not serve one a browser is allowed to fetch — so the tool would report perfectly good credentials as unverified. Reporting a genuine credential as unproven is the most damaging thing a verification tool can do, so it reports what the proof claims and says plainly that it has not checked it.

It also cannot tell you whether the issuer is who they say they are. A structurally perfect badge from an organisation nobody recognises is still a structurally perfect badge.

It is also our own conformance harness

The same rules run against our own endpoints in the API's test suite, so "conformant" is something a test run demonstrates rather than something a marketing page asserts.