Schema Reference · W3C · JSON-LD · ROOT-LD

The vocabulary
machines read.

Schema.org is the shared vocabulary that lets any website declare what it is to any machine that comes looking. This page is a complete reference — the history, the data, the formats, the AI implications, and live JSON-LD for six entity types.

Page updated 2026-05-03T09:00:00Z · W3Techs data verified 2026-03-29 · schema.org vocabulary 827 types · 1,528 properties · verified 2026-05-01 · W3C status JSON-LD 1.1 Recommendation · 2020-07-16
What Is Schema

schema.org · W3C · JSON-LD

Every website serves two audiences. The human who reads it. The machine that processes it. Schema is the bridge between the two — a standardized vocabulary that lets a website declare what it is in a format any machine can read, parse, and reason from.

The technical format is JSON-LD — JavaScript Object Notation for Linked Data. It lives in the <head> of an HTML document as a script block. Invisible to human visitors. Structural to every machine that processes the page.

The vocabulary is schema.org — 827 types, 1,528 properties, covering every category of entity that exists on the web. Business name. Location. Hours. Services. Relationships to industry, geography, and adjacent entities. All of it typed, labeled, and machine-readable in a format that search engines and AI systems are built to read.

This page documents the standard as it exists — its origin, its data, its formats, its relationship to AI reasoning, and its implementation. The live examples at the bottom are production-ready JSON-LD for six entity types. Every source cited traces to a primary document.

Quick Reference
Standard Schema.org
Format JSON-LD 1.1
Types 827
Properties 1,528
W3C Status Recommendation
W3C Date 16 July 2020
Web Adoption 53.2% · March 2026
Origin

2011 · Four search engines · One vocabulary

In 2011, four competing companies — Google, Microsoft, Yahoo, and Yandex — agreed on a shared vocabulary for structured data on the web. They launched schema.org with 297 types and 187 properties. One standard. Every major search engine would accept it.

The three engineers who drove schema.org into existence were R.V. Guha at Google — who had previously created RSS and co-led the Cyc project — Dan Brickley, who had contributed to the Semantic Web project at W3C, and Steve Macbeth at Microsoft. Their work is documented in a 2016 paper published in ACM Communications. cacm.acm.org/practice/schema-org/

Within four years of launch, 31.3% of pages in the Google index carried schema.org markup. The vocabulary has grown continuously since. As of May 2026 it contains 827 types and 1,528 properties. The W3C issued JSON-LD 1.1 as a full Recommendation on 16 July 2020 — the highest level of endorsement the standards body issues.

827
Schema.org types
1,528
Properties in vocabulary
53.2%
Web adoption · March 2026
2011
Year launched
Adoption Data

W3Techs · March 2026 · Cited

W3Techs publishes usage statistics for structured data formats across the web, updated daily. As of March 29, 2026, 53.2% of all websites use JSON-LD — up from 18.1% in January 2018. JSON-LD is the dominant structured data format by adoption share.

The adoption statistics measure binary presence — JSON-LD exists on a page or it does not. Coverage depth against the full schema.org vocabulary for a given entity type is a separate measurement. The Global Data Registry measures both.

JSON-LD Adoption — Historical Yearly Trend · W3Techs
Format 2018 2020 2022 2024 Jan 2026 Mar 2026
Open Graph36.0%46.1%60.1%65.5%69.8%70.3%
Twitter / X Cards19.3%29.8%46.7%50.1%55.3%56.0%
JSON-LD18.1%28.2%41.3%46.5%52.5%53.2%
Generic RDFa13.1%13.5%32.4%38.9%39.4%39.0%
Microdata13.1%15.3%21.5%24.7%23.1%22.7%
None55.1%44.3%30.3%25.1%21.7%21.4%
◈ Measurement scope

These statistics measure binary presence — JSON-LD exists on a page or it does not. They do not measure coverage depth against the schema.org vocabulary. The Global Data Registry measures schema coverage as a percentage of the available vocabulary for a given entity type, scored against all 827 types and 1,528 properties.

Source: W3Techs · w3techs.com/technologies/details/da-jsonld · Verified 2026-03-29
Formats

Microdata · RDFa · JSON-LD

Schema.org launched in 2011 supporting three implementation formats.

Microdata embeds structured markup directly inside HTML tags. The data layer and presentation layer share the same code.

RDFa — Resource Description Framework in Attributes — is the more expressive academic format, implemented through HTML attributes.

JSON-LD separates the structured data entirely from the visible HTML. Schema lives in a script block in the document head — a self-contained JSON object that declares the entity without touching front-end code. Google began recommending JSON-LD in 2014. The W3C issued it as a full Recommendation in 2020. It is the standard format across all major search and AI systems.

Format Comparison — Same Data, Three Syntaxes schema.org · LocalBusiness
/* ── MICRODATA — embedded in HTML tags ── */ <div itemscope itemtype="https://schema.org/LocalBusiness"> <span itemprop="name">Example Business</span> </div> /* ── RDFa — embedded in HTML attributes ── */ <div vocab="https://schema.org/" typeof="LocalBusiness"> <span property="name">Example Business</span> </div> /* ── JSON-LD — separate from HTML · W3C Recommendation ✓ ── */ <script type="application/ld+json"> { "@context": "https://schema.org", "@type": "LocalBusiness", "name": "Example Business" } </script>
W3C Recommendation · JSON-LD 1.1 · Published 2020-07-16 W3C Spec →
Schema and AI Reasoning

From ranking to reasoning

Search engines historically used schema as a ranking signal — structured data provided explicit signals that improved result accuracy. Large language models introduced a different relationship with structured data.

AI systems construct entity models. When a system processes a query about a business, a location, or a concept, it draws from an entity model built during training. Schema.org markup is one of the primary structural inputs into that model. Every declared property is a confirmed fact the system can reason from. Every declared relationship is an edge in the model — a connection between entities the system uses to reason about context.

The relationship between schema coverage and AI citation confidence is structural. A declared property eliminates inference. A declared relationship establishes a confirmed edge between entities. The registry measures schema coverage, mints entities with full provenance, and injects confirmed graph edges into the JSON-LD — giving AI systems a dense, falsifiable, provenanced record to reason from.

Without Schema — Machine receives unstructured · inference required
/* Crawler arrives and finds: */ <div class="header">Welcome to Our Business</div> <p>We serve great customers.</p> <p>Call us or visit us today!</p> /* System must infer from context: */ ? Entity type ? Location ? Services offered ? Operating hours ? Ownership and identity ? Related entities
Unstructured HTML — All fields inferred
With Schema — Machine receives structured · declared · zero inference
/* Crawler arrives and finds: */ { "@context": "https://schema.org", "@type": "LocalBusiness", "name": "Example Business", "address": { /* full PostalAddress */ }, "openingHours": "Mo-Fr 09:00-17:00", "sameAs": ["https://maps.google.com/..."] } /* System reads with certainty: */ Type declared Location confirmed Hours declared Identity confirmed across sources
Structured JSON-LD — All fields declared schema.org/LocalBusiness →
Coverage

Thin schema vs rich schema

Schema coverage measures how many of the available properties for a given entity type are declared. A Dentist entity has a defined vocabulary — every applicable property that could be declared for that type. Coverage is the ratio of declared properties to available properties.

The registry scores every indexed entity against its full vocabulary. The score is a percentage — declared properties divided by the total applicable to that entity type.

Coverage Comparison — Same Entity Type LocalBusiness · schema.org/Dentist
/* ── LOW COVERAGE ── */ { "@context": "https://schema.org", "@type": "Dentist", "name": "Example Dental", "telephone": "+1-555-000-0000" } /* 3 fields declared. Coverage: ~8% of available vocabulary for Dentist type. */ /* ── FULL COVERAGE — GDR standard ── */ { "@context": "https://schema.org", "@type": "Dentist", "@id": "https://exampledental.com/#organization", "name": "Example Dental", "description": "Family and cosmetic dentistry — declared description", "telephone": "+1-555-000-0000", "foundingDate": "2008", "address": { /* full PostalAddress */ }, "geo": { "@type": "GeoCoordinates", "latitude": 00.0000, "longitude": -000.0000 }, "openingHoursSpecification": [ /* full spec per day */ ], "hasOfferCatalog": { /* services declared */ }, "aggregateRating": { /* rating + review count */ }, "sameAs": [ /* verified external profiles */ ], "areaServed": [ /* geographic service area */ ], "knowsAbout": [ /* GDR edge injection: regulations, industry cluster */ ], "gdr:schemaScore": 0.89, "gdr:rootLD": "rld:anchor", "gdr:verified": true } /* 30+ fields declared. Coverage: 85%+ of available vocabulary. */ /* Graph edges baked in from GDR entity graph. */
GDR Schema Score · Full Entity · Graph-Connected · ROOT-LD schema.org/Dentist →
The Registry Pipeline

Score · Enrich · Inject · Mint

01 · Score
Schema measurement

Every indexed entity is scored against the full schema.org vocabulary for its type. Coverage depth measured against all applicable properties.

02 · Enrich
Full vocabulary coverage

A structured intake process captures what the entity is. That information is normalized and generates a complete, vocabulary-aligned JSON-LD block targeting maximum coverage for the entity type.

03 · Inject
Graph edge declaration

The entity is run against the indexed entity graph. Confirmed relationships are baked into the schema — regulatory bodies, industry clusters, geographic markets — with provenance links.

04 · Mint
Permanent entity record

The entity receives a permanent profile in the graph — machine-readable, with a full provenance chain, edge map, schema score, UUID, and ROOT-LD context pod.

Live JSON-LD Examples

Copy · Validate · Implement

Production-ready JSON-LD for six entity types. Each block targets maximum field coverage for the entity class. Copy directly into the <head> of your HTML inside a <script type="application/ld+json"> tag. Replace placeholder values with actual data.

Restaurant — Food & Beverageschema.org/Restaurant
{ "@context": "https://schema.org", "@type": "Restaurant", "@id": "https://yourrestaurant.com/#organization", "name": "Your Restaurant Name", "description": "[cuisine type, atmosphere, what makes you different]", "url": "https://yourrestaurant.com", "telephone": "+1-XXX-XXX-XXXX", "priceRange": "$$", "servesCuisine": ["American", "Craft Cocktails"], "hasMenu": "https://yourrestaurant.com/menu", "acceptsReservations": true, "address": { "@type": "PostalAddress", "streetAddress": "123 Main Street", "addressLocality": "Your City", "addressRegion": "CA", "postalCode": "XXXXX", "addressCountry": "US" }, "geo": { "@type": "GeoCoordinates", "latitude": 00.0000, "longitude": -000.0000 }, "openingHoursSpecification": [ { "@type": "OpeningHoursSpecification", "dayOfWeek": ["Monday","Tuesday","Wednesday","Thursday"], "opens": "11:00", "closes": "22:00" }, { "@type": "OpeningHoursSpecification", "dayOfWeek": ["Friday","Saturday"], "opens": "11:00", "closes": "02:00" } ], "aggregateRating": { "@type": "AggregateRating", "ratingValue": 4.7, "reviewCount": 284 }, "sameAs": ["https://yelp.com/biz/...", "https://maps.google.com/..."] }
schema.org/Restaurant
Law Firm — Legal Servicesschema.org/LegalService
{ "@context": "https://schema.org", "@type": "LegalService", "@id": "https://yourlawfirm.com/#organization", "name": "Your Law Firm", "description": "[practice areas, jurisdiction, years in practice]", "url": "https://yourlawfirm.com", "telephone": "+1-XXX-XXX-XXXX", "foundingDate": "YYYY", "address": { "@type": "PostalAddress", /* full address */ }, "geo": { "@type": "GeoCoordinates", "latitude": 00.0000, "longitude": -000.0000 }, "openingHours": "Mo-Fr 09:00-17:00", "knowsAbout": ["Personal Injury Law", "Civil Litigation", "California Labor Code"], "hasOfferCatalog": { "@type": "OfferCatalog", "name": "Legal Services", "itemListElement": [{ "@type": "Offer", "itemOffered": { "@type": "Service", "name": "Personal Injury Representation" } }] }, "areaServed": [{ "@type": "State", "name": "California" }], "aggregateRating": { "@type": "AggregateRating", "ratingValue": 4.9, "reviewCount": 147 }, "sameAs": ["https://avvo.com/...", "https://martindale.com/..."] }
schema.org/LegalService
Contractor — Construction & Homeschema.org/HomeAndConstructionBusiness
{ "@context": "https://schema.org", "@type": "HomeAndConstructionBusiness", "@id": "https://yourcontractor.com/#organization", "name": "Your Contracting Company", "description": "[licensed contractor — specialties, years, license number, service area]", "url": "https://yourcontractor.com", "telephone": "+1-XXX-XXX-XXXX", "foundingDate": "YYYY", "address": { "@type": "PostalAddress", /* full address */ }, "hasOfferCatalog": { "@type": "OfferCatalog", "name": "Construction Services", "itemListElement": [{ "@type": "Offer", "itemOffered": { "@type": "Service", "name": "Kitchen Remodeling" } }, { "@type": "Offer", "itemOffered": { "@type": "Service", "name": "ADU Construction" } }] }, "areaServed": [{ "@type": "City", "name": "Your City" }], "knowsAbout": ["California Building Code", "CSLB License Requirements"], "aggregateRating": { "@type": "AggregateRating", "ratingValue": 4.8, "reviewCount": 93 }, "sameAs": ["https://houzz.com/...", "https://bbb.org/..."] }
schema.org/HomeAndConstructionBusiness
Medical Clinicschema.org/MedicalClinic
{ "@context": "https://schema.org", "@type": "MedicalClinic", "@id": "https://yourclinic.com/#organization", "name": "Your Medical Clinic", "description": "[specialties, patient demographics, what makes you different]", "url": "https://yourclinic.com", "telephone": "+1-XXX-XXX-XXXX", "medicalSpecialty": ["Family Medicine", "Preventive Medicine"], "availableService": [{ "@type": "MedicalProcedure", "name": "Annual Physical Exam" }, { "@type": "MedicalProcedure", "name": "Telehealth Visits" }], "address": { "@type": "PostalAddress", /* full address */ }, "geo": { "@type": "GeoCoordinates", "latitude": 00.0000, "longitude": -000.0000 }, "openingHoursSpecification": [{ "@type": "OpeningHoursSpecification", "dayOfWeek": ["Monday","Tuesday","Wednesday","Thursday","Friday"], "opens": "08:00", "closes": "18:00" }], "aggregateRating": { "@type": "AggregateRating", "ratingValue": 4.6, "reviewCount": 201 }, "sameAs": ["https://healthgrades.com/...", "https://zocdoc.com/..."] }
schema.org/MedicalClinic
Real Estate Agentschema.org/RealEstateAgent
{ "@context": "https://schema.org", "@type": "RealEstateAgent", "@id": "https://yourrealty.com/#organization", "name": "Your Realty Group", "description": "[markets served, specialties, volume, years in business]", "url": "https://yourrealty.com", "telephone": "+1-XXX-XXX-XXXX", "address": { "@type": "PostalAddress", /* full address */ }, "geo": { "@type": "GeoCoordinates", "latitude": 00.0000, "longitude": -000.0000 }, "areaServed": [{ "@type": "City", "name": "Your City" }], "hasOfferCatalog": { "@type": "OfferCatalog", "name": "Real Estate Services", "itemListElement": [{ "@type": "Offer", "itemOffered": { "@type": "Service", "name": "Buyer Representation" } }, { "@type": "Offer", "itemOffered": { "@type": "Service", "name": "Seller Representation" } }] }, "knowsAbout": ["California Real Estate Law", "1031 Exchange", "DRE License Requirements"], "aggregateRating": { "@type": "AggregateRating", "ratingValue": 4.9, "reviewCount": 178 }, "sameAs": ["https://zillow.com/...", "https://realtor.com/..."] }
schema.org/RealEstateAgent
Auto Repair — Automotiveschema.org/AutoRepair
{ "@context": "https://schema.org", "@type": "AutoRepair", "@id": "https://yourautorepair.com/#organization", "name": "Your Auto Repair Shop", "description": "[specialties, certifications, makes/models serviced]", "url": "https://yourautorepair.com", "telephone": "+1-XXX-XXX-XXXX", "openingHours": "Mo-Fr 07:30-17:30", "address": { "@type": "PostalAddress", /* full address */ }, "geo": { "@type": "GeoCoordinates", "latitude": 00.0000, "longitude": -000.0000 }, "hasOfferCatalog": { "@type": "OfferCatalog", "name": "Auto Services", "itemListElement": [{ "@type": "Offer", "itemOffered": { "@type": "Service", "name": "Engine Diagnostics" } }, { "@type": "Offer", "itemOffered": { "@type": "Service", "name": "Brake Service" } }, { "@type": "Offer", "itemOffered": { "@type": "Service", "name": "Oil Change" } }] }, "knowsAbout": ["ASE Certified Technicians", "California BAR Registration"], "aggregateRating": { "@type": "AggregateRating", "ratingValue": 4.7, "reviewCount": 156 }, "sameAs": ["https://yelp.com/...", "https://carfax.com/..."] }
schema.org/AutoRepair
6 entity types · validate at search.google.com/test/rich-results
References & Provenance

Primary sources · Cited · Verified

Every claim on this page traces to a primary document. Source, author, URL, and date — declared for each reference.

[W3C-01]
JSON-LD 1.1 W3C Recommendation Published: 16 July 2020 · Status: W3C Recommendation https://www.w3.org/TR/json-ld11/
[SCH-01]
Schema.org Full Vocabulary — 827 Types · 1,528 Properties https://schema.org/docs/schemas.html
[SCH-02]
Schema.org Data Model Overview https://schema.org/docs/datamodel.html
[GOO-01]
Introduction to Structured Data — Google Search Central developers.google.com/search/docs/appearance/structured-data/intro-structured-data
[ACM-01]
Schema.org: Evolution of Structured Data on the Web Guha, R.V. · Brickley, Dan · Macbeth, Steve · ACM Communications · February 2016 https://cacm.acm.org/practice/schema-org/
[SEM-01]
The Semantic Web Berners-Lee, Tim · Hendler, James · Lassila, Ora · Scientific American · May 2001 https://www.scientificamerican.com/article/the-semantic-web/
[W3T-01]
JSON-LD Usage Statistics — W3Techs Verified: 2026-03-29 · JSON-LD used by 53.2% of all websites https://w3techs.com/technologies/details/da-jsonld
[RL-01]
ROOT-LD Specification — Open Linked Data Standard https://root-ld.org
[RL-02]
Recursive-LD Specification — Open Linked Data Standard https://recursive-ld.org
[GDR-01]
Global Data Registry — Publications & Research Ongoing · provenance substrate · entity indexing · schema coverage analysis globaldataregistry.com/publications
All sources primary · all links verified · last updated 2026-05-03
[Page Service Name] is a service of the Global Data Registry  —  open provenance infrastructure for the machine-readable web.
View the Registry →