Learn About Schemas — Guides & Tutorials
Free, in-depth guides on structured data markup, database design, and API development.
How to use this library
Each guide here is built around a single decision or workflow rather than a topical overview. If you read one all the way through you should leave with a usable answer — not a checklist of things to look up later. The guides assume you can read code but not that you have prior expertise in the topic; every term is defined the first time it appears.
Three reading paths cover most cases. If you have never added structured data before, start with the Beginner's Guide to Schema Markup, then read JSON-LD vs Microdata vs RDFa to understand the format choice, then read Structured Data for AI Search Engines once you are ready to optimize. If your work is server-side, read Database Schema Design Fundamentals for the relational basics and the JSON Schema Guide for API contracts. If you maintain a public API, the API Versioning Best Practices guide is the highest-leverage thing you can read this quarter.
Every guide links back to the relevant tool on the site so you can apply what you learn against a real example as you read. The tools are free and require no signup.
How the library is organized
The guides are grouped under three categories that match the structure of the rest of the site. Markup covers Schema.org structured data: what it is, why it matters for both classic search and AI-driven search, which format to choose, and how to write JSON-LD that is both valid and citation-ready. Database covers the relational schema fundamentals every application engineer ends up needing — normalization, relationships, naming, audit columns, soft deletes — written without the academic jargon that surrounds the topic in textbooks. API covers JSON Schema and OpenAPI: how to describe payloads and contracts, how to evolve them without breaking consumers, and how to detect breaking changes before they ship. Every guide is written to be read in one sitting and to leave you with one fewer decision to make.
Pages here are intentionally not stub articles padded out with synonyms. We aim for working-engineer length: long enough to cover the material, short enough that you finish. Where a topic has a long tail of edge cases, we link out to the canonical specification — the W3C document, the IETF RFC, the Schema.org type page, the Postgres or MySQL reference manual — rather than inflate the guide. Each guide closes with a Sources and further reading section listing every external reference, so you can verify any claim or dig deeper without having to search for it.
Drawn from production work, the guides reflect decisions our team has made on real projects. Where there is a single clear answer we say so. Where the answer is "it depends," we name the variables and the trade-offs instead of hedging with weasel words. The structure of each guide is consistent: a short framing of the problem, the conceptual material, a worked example, and a closing decision rule you can apply tomorrow.
The Complete Beginner's Guide to Schema Markup
What schema markup is and why it matters for search, the main schema.org types, the three formats (JSON-LD, Microdata and RDFa), how to write JSON-LD and test it, the most common mistakes and best practices, and a first block of markup to start from. Ends with answers to frequent questions.
JSON-LD vs Microdata vs RDFa — Which Should You Use?
The three schema.org formats side by side: how JSON-LD, Microdata and RDFa each work, a comparison table, which to choose, how to migrate from Microdata or RDFa to JSON-LD, and whether you can mix formats on one page.
How to Optimize Structured Data for AI Search Engines
How AI search engines use structured data, why it matters more for them than for classic results, practical optimization strategies, what they can't get from unstructured content, how to measure your AI search performance, and how to keep your markup future-proof.
Database Schema Design Fundamentals
Why schema design matters, normalization, modeling one-to-one, one-to-many and many-to-many relationships, naming conventions, common design patterns, anti-patterns to avoid, and practical tips. Written for application developers who own a schema without being database specialists.
JSON Schema — The Complete Guide
What JSON Schema is, how its drafts differ, the core validation and composition keywords, references with $ref, conditional schemas with if/then/else, real-world uses, and best practices.
API Schema Versioning Best Practices
Semantic versioning for APIs, breaking and non-breaking changes, versioning strategies, backward compatibility, migration planning, changelog practices, and automating schema version checks.