Certificate metadata schema
Foundational · 5 min read
A reusable schema for certificates and non-transferable credentials.
Required fields
certificate_id (UUID), title, issuer_name, recipient_display (public-safe), issued_at (ISO-8601), criteria (what was completed), transferability (“non-transferable” recommended), network, schema_version, disclaimer.
Optional extensions
course_id, hours, skills[], evidence_url (public syllabus), expires_at (if credentials expire), language, locale.
Verification notes
Publish a machine-readable schema (JSON) and a human verify page. Sign metadata with an issuer key if you go beyond pure mock. Always keep educational disclaimers adjacent to the credential display.
Example payload
{
"certificate_id": "cert_demo_001",
"title": "Bitcoin Tokenization Safety — Module Complete",
"issuer_name": "MakeYourOwnBitcoin.com Learning Center",
"recipient_display": "learner@example.invalid",
"issued_at": "2026-07-15T00:00:00.000Z",
"criteria": "Completed sandbox simulation and compliance preflight quiz",
"transferability": "non-transferable",
"network": "testnet",
"schema_version": "1.0.0",
"disclaimer": "Educational credential only. Not a security or investment product."
}