What Is Schema.org? Vocabulary, Types, Properties, and Common Misconceptions

Schema.org is a collaborative, community-maintained vocabulary for describing entities, relationships, and actions in structured data on web pages, email, and other digital surfaces. It supplies standardized types such as Organization and Article, properties such as name and author, and enumerated values. Publishers express those terms through encodings including JSON-LD, Microdata, or RDFa so compatible systems can interpret the same facts consistently.

Schema.org solves a naming problem. A publisher may know that a page is about an organization, that a person wrote an article, or that an offer has a price. Machines need stable terms for those entities and relationships. The Schema.org project maintains that shared dictionary and the definitions behind it.

It does not supply a mathematical formula. There is also no accepted target for how many types or properties a page should contain, no universal validation score, and no dependable equation that turns markup into rankings, traffic, rich results, or AI citations. Those outcomes depend on the consuming system, the underlying content, and the accuracy and eligibility of the implementation.

Schema.org defines and maintains a shared collection of types, properties, and enumerated values for structured data. Its vocabulary covers entities, relationships, and actions, and it is developed through an open community process.

Schema.org’s own FAQ says it is not a formal standards body like the W3C or IETF. It is a collaborative vocabulary project with a documented community process. That distinction matters: Schema.org defines terms, while consuming platforms decide which terms they support and how they use them.

Schema.org is the vocabulary layer

Several related terms are routinely compressed into the word “schema.” Separating their jobs makes the whole subject easier to reason about.

LayerThe question it answersExample
Page factWhat is true in the content?This page is an article with a headline.
Structured dataHow are those facts represented for machines?An entity connected to named values and other entities.
Schema.org vocabularyWhich shared terms name those things and relationships?Article and headline.
EncodingHow are those terms written into a document?JSON-LD, Microdata, or RDFa.
Consumer contractWhich terms does a product recognize, require, or recommend?A Google rich-result feature guide.
Consumer outputWhat does the product decide to do with eligible data?A rich result, an internal graph connection, or no visible change.

This distinction explains why Schema.org and JSON-LD are not synonyms. Schema.org supplies vocabulary. The W3C JSON-LD specification defines a JSON-based serialization for linked data; it can carry Schema.org terms, terms from another vocabulary, or a combination. Microdata and RDFa can carry the same Schema.org vocabulary in different syntax.

Here is a deliberately small illustration based on this article:

{
  "@context": "https://schema.org",
  "@type": "Article",
  "headline": "What Is Schema.org? Vocabulary, Types, Properties, and Common Misconceptions"
}

In that JSON-LD block, @context identifies how compact terms should be interpreted, Article is a Schema.org type, and headline is a Schema.org property. The braces, quotes, and @ keywords belong to JSON-LD syntax. None of those lines by itself promises that a search product will show a special result.

Schema.org vocabulary can be expressed with JSON-LD, Microdata, or RDFa. JSON-LD is a serialization for linked data, while Schema.org supplies terms that can be used within that serialization.

The phrase schema markup usually means the page-level implementation of Schema.org terms. Structured data is broader: it is the machine-readable representation. A rich result is a possible presentation chosen by a consumer such as Google. In other technical contexts, “schema” can mean a database schema, JSON Schema, or XML Schema; those are separate systems with different purposes.

Types classify entities; properties make claims about them

A type says what kind of entity is being described. Person, Organization, Article, Product, and Event are types. Schema.org writes type names in TitleCase and arranges them in a hierarchy rooted at Thing. A more specific type inherits properties associated with its supertypes, and the model permits more than one supertype.

A property says something about an entity or connects it to another value. name, author, datePublished, and address are properties. Property names normally use lowerCamelCase. A property may accept a simple value such as text, a URL, a date, an enumerated value, or another typed entity.

Schema.org term pages show two associations that are useful when reading a property:

  • Used on these types, represented in the data model by domainIncludes, identifies the kinds of entity for which the property is commonly applicable.
  • Expected types, represented by rangeIncludes, identifies the kinds of value normally supplied for that property.

Those associations can be plural. A property may be useful on several types, and its value may accept more than one type. Schema.org also allows properties to have multiple values. This is why a real description behaves more like a graph than a flat spreadsheet row: an Article can link through author to a Person, and that person can have their own properties and identifiers.

Schema.org types are arranged in a multiple-inheritance hierarchy and take associated properties from supertypes. Properties identify common subject types and expected value types, can accept multiple expected types, and can have multiple values.

The vocabulary includes a few other building blocks:

Building blockRoleExample
TypeClassifies an entityOrganization
PropertyExpresses an attribute or relationshipfounder
DatatypeConstrains a literal value’s basic formDate, Number, or Text
EnumerationDefines a controlled family of valuesItemAvailability
Enumeration memberSupplies one value from that familyInStock

The current Schema.org development site reports 823 types and 1,529 properties in version 30.0, alongside datatypes and enumeration terms. Those counts describe the vocabulary at one release. They are not a goal for a page, and they will change as the project evolves.

The vocabulary is intentionally flexible

Schema.org is not a closed form schema in the database sense. Its data-model documentation describes type-property associations as pragmatic guidance rather than rigid formal constraints. It also says the vocabulary is not intended to be a universal ontology of everything.

That flexibility appears in three places.

First, Schema.org itself has no notion of a mandatory property. Different pages contain different facts, and different consumers need different subsets. The project’s governance documentation leaves required fields to consuming services rather than declaring them globally.

Second, Schema.org follows an open-world interpretation. If a property is absent, the safe meaning is “unknown,” not “false.” A page that omits petsAllowed, for example, has not asserted that pets are prohibited. It has supplied no claim about the subject.

Third, expected types are guidance about useful combinations, not permission to ignore semantics. A parser may tolerate text where a more specific entity would be richer, but a loose parser does not make an inaccurate claim correct. The term’s definition still matters.

Schema.org tells you what a term means. The consuming product tells you which terms it needs. The page tells you which claims are true.

This three-part rule resolves the recurring question, “Do I have to mark up every property?” No. Add properties that accurately describe available content, then consult the intended consumer’s documentation for any required or recommended subset. In Google’s case, a feature guide can impose requirements that Schema.org itself does not.

Schema.org defines no globally mandatory properties and treats omission as unknown rather than false. A consuming service can separately define required, recommended, and optional properties for its own features.

A valid Schema.org term is not automatically a Google feature

Schema.org and Google Search have overlapping but different contracts. Schema.org documents a broad vocabulary. Google says most of its Search structured data uses that vocabulary, but directs publishers to Google Search Central—not the Schema.org reference—for definitive Google behavior.

That means two questions must be tested independently:

  1. Is the structured data meaningful according to Schema.org? Check whether the types, properties, values, and relationships express the intended facts.
  2. Is the page eligible for a specific consumer feature? Check that consumer’s supported types, required fields, quality policies, access rules, and content rules.

Google maintains a bounded gallery of supported structured-data features. The complete Schema.org vocabulary is much larger. A legitimate Schema.org type can therefore be meaningful to other consumers or internal systems without corresponding to a Google rich result.

Even supported and correctly implemented markup only creates eligibility. Google’s general structured-data guidelines explicitly say that a valid implementation does not guarantee display. The system may choose another presentation, and content can remain ineligible when the markup is misleading, does not represent the main page content, describes hidden information, or violates feature-specific guidance.

Google supports a documented subset of structured-data features, applies its own feature requirements, and does not guarantee a rich result even when markup is technically correct.

This also puts ranking claims in their proper place. Schema.org can make a page’s explicit statements easier for compatible systems to parse. That is a useful capability, but it is not evidence of a guaranteed ranking increase. Google recommends measuring effects on a site’s own pages rather than importing a universal lift estimate.

Validation answers different questions

“The markup validates” is incomplete unless the tool and the claim are named.

The Schema Markup Validator checks Schema.org-based structured data without Google feature-specific warnings. Google’s Rich Results Test asks which Google rich-result features the detected markup may generate. URL Inspection then helps verify what Google retrieved from a deployed page.

These tools cover different layers:

CheckWhat it can establishWhat it cannot establish by itself
Syntax and parsingThe encoding can be read and terms can be extracted.The claims are true or useful.
Schema.org validationTerms and relationships can be assessed against the vocabulary.Google supports a corresponding rich result.
Rich-result testingGoogle recognizes data relevant to a supported feature and can report feature issues.The feature will be displayed.
Production inspectionA crawler can retrieve the rendered implementation.The markup will remain accurate after future content changes.
Content reviewThe structured claims match visible page facts and use the intended meanings.A consumer will select a particular presentation.

Automated validation cannot know whether a price is current, an author identity is correct, or a marked-up fact is misleading in context. That is why passing a tool is evidence about one layer, not a certificate for the whole implementation.

The Schema Markup Validator and Rich Results Test evaluate different contracts, and Google cautions that automated tests cannot catch every content-quality, accuracy, or eligibility problem.

More markup is useful only when it carries better facts

Vocabulary size can encourage completionism: choose every type that sounds plausible and populate every available property. That approach increases maintenance cost and semantic risk without creating a universal benefit.

A smaller description is often stronger when it preserves the page’s important entities and relationships accurately. Use the most specific type whose documented meaning fits. Prefer identifiers and nested entities when they remove real ambiguity. Add properties that a consumer or downstream decision actually uses. Leave unsupported facts out rather than guessing.

Take extra care with terms in Schema.org’s pending section. The project describes that section as a staging area where terminology may still change. Pending vocabulary can be appropriate for experimentation, but it carries a different stability expectation from the core vocabulary and demands deliberate monitoring.

The same caution applies to term names that look familiar. Schema.org’s style guide notes that a type has a specific semantic definition beyond its everyday label. Selecting a term because its name “sounds right” can encode the wrong entity even when the JSON is flawless.

Schema.org is not an AI-citation switch

Structured descriptions may be useful to systems that consume them, but public documentation does not support a universal promise that Schema.org markup earns an AI citation. Each product can choose whether, how, and which vocabulary terms it processes.

For Google’s AI Overviews and AI Mode, the current site-owner guidance is unusually direct: there is no special Schema.org markup or additional technical requirement for those features. Pages need normal Search eligibility, important information should remain available in visible text, and any structured data should agree with that text.

That statement is bounded to Google Search. It does not prove that every answer engine ignores structured data, nor does it prove that any other engine rewards it. The defensible practice is to publish accurate visible content, use structured data where a documented consumer or interoperability need justifies it, and treat AI visibility as an outcome to observe rather than a promise embedded in the markup.

Google states that AI Overviews and AI Mode require no special Schema.org markup or additional technical requirement, while recommending that any structured data match visible page text.

A practical way to read any Schema.org term

When a type or property looks useful, walk through six questions before adding it:

What real entity or relationship are you describing?

Write the claim in plain language first.

Does the term's definition match that claim?

Read the definition, hierarchy, and examples rather than relying on the label alone.

Is the term stable enough for the use?

Check whether it is core, pending, or superseded and plan maintenance accordingly.

Do the property and value fit?

Review the associated subject types and expected value types, then use a nested entity or identifier where that conveys a real relationship.

What does the intended consumer require?

Check its own supported-feature documentation; do not infer support from Schema.org’s catalog.

Can you keep the claim synchronized?

Validate the encoding and consumer eligibility, compare it with visible content, deploy it, and monitor the rendered result.

This sequence is more durable than memorizing a list of popular types. The vocabulary will evolve, consumer support will change, and each page will expose different facts. The decision rule remains stable: model true claims with the clearest shared terms that an actual consumer or interoperability need can justify.

Use Schema.org as a language agreement

Schema.org is most valuable when several systems need a common way to refer to the same entities and relationships. It gives publishers a maintained vocabulary, examples, identifiers, and an extensible data model. Encodings such as JSON-LD carry that vocabulary, while consumers decide which parts they recognize and what they do with them.

The decision
Use it when the shared semantics have a clear purpose and your team can keep the claims accurate. Do not treat the size of the vocabulary, a green validator result, or the presence of an @type as a performance strategy. The useful outcome is simpler: a machine that understands the vocabulary can read a more explicit account of what the page already says.

Sources

  1. Schema.org, “Schema.orgSupports: Schema.org is a collaborative community activity that creates and maintains schemas for structured data; Its vocabulary describes entities, relationships, and actions; Schema.org terms can be expressed with JSON-LD, Microdata, or RDFa; The project was founded by Google, Microsoft, Yahoo, and Yandex and now uses an open community process. Checked 2026-08-24.Limitation: This is the project's own overview. It defines the vocabulary's mission and governance but does not establish that a particular consumer uses every term or that markup changes rankings, rich-result display, traffic, or AI citations.
  2. Schema.org, “SchemasSupports: Schema.org organizes types in a hierarchy and associates types with properties; Version 30.0 lists 823 types, 1,529 properties, 19 datatypes, 96 enumerations, and 535 enumeration members; Pending terms are under discussion and may change significantly. Checked 2026-08-24.Limitation: The inventory is a versioned snapshot of the development site, not a quality benchmark, an implementation target, or a list of features supported by any search or AI product.
  3. Schema.org, “Data modelSupports: Schema.org types form a multiple-inheritance hierarchy; Properties have one or more expected subject types and one or more expected value types; Properties can have multiple values; Type-property associations are pragmatic guidance rather than strict formal constraints; Schema.org is not intended as a universal ontology. Checked 2026-08-24.Limitation: This document explains Schema.org's flexible data model. It does not replace a consuming platform's validation, eligibility, or quality rules.
  4. Schema.org, “How we workSupports: Schema.org defines a dictionary of types, properties, and enumerated values; Thing is the root of the main type hierarchy; Schema.org itself defines no mandatory property; Term definitions and type-property associations evolve through a community process. Checked 2026-08-24.Limitation: This is vocabulary-governance documentation. Consumer-specific required and recommended fields must be verified separately.
  5. Schema.org, “Style guideSupports: Schema.org distinguishes types, properties, and enumerated values; Types use TitleCase and properties use lowerCamelCase; Types inherit properties from supertypes; Under Schema.org's open-world approach, omitting a property means unknown rather than false. Checked 2026-08-24.Limitation: This guide describes Schema.org term design and interpretation, not all publisher requirements or downstream product behavior.
  6. Schema.org, “FAQSupports: Schema.org's purpose is to provide a shared structured-data vocabulary; Schema.org is not a formal standards body; Not every Schema.org information type is surfaced in search results; Publishers do not have to mark up every property; Both HTTP and HTTPS Schema.org identifiers remain understood, with HTTPS preferred in current examples. Checked 2026-08-24.Limitation: Some historical names and examples reflect the project's origins. Current feature support and implementation rules must be checked in each consumer's current documentation.
  7. World Wide Web Consortium, “JSON-LD 1.1Supports: JSON-LD is a JSON-based format for serializing linked data; A JSON-LD context maps compact terms to vocabulary identifiers; A JSON-LD document can combine terms from more than one vocabulary. Checked 2026-08-24.Limitation: This is the normative JSON-LD syntax specification. It does not define Schema.org terms or document search-engine feature support.
  8. Google Search Central, “Introduction to structured data markup in Google SearchSupports: Google treats structured data as explicit clues about a page's meaning; Most Google Search structured data uses Schema.org vocabulary, but Google documentation is definitive for Google behavior; Google supports JSON-LD, Microdata, and RDFa and generally recommends JSON-LD for maintainability; Google feature guides can define required, recommended, and optional properties; Google recommends site-specific before-and-after measurement. Checked 2026-08-24.Limitation: This source documents Google Search, not every consumer. Its feature rules and case studies do not create universal Schema.org requirements or performance benchmarks.
  9. Google Search Central, “General structured data guidelinesSupports: Correct structured data does not guarantee that Google will display a rich result; Markup should represent the page's main visible content and must not be misleading; Automated tests cannot catch every content-quality or truth problem. Checked 2026-08-24.Limitation: These are Google-specific eligibility and quality policies. Other consumers may recognize different vocabulary terms or impose different rules.
  10. Google Search Central, “Structured data markup that Google Search supportsSupports: Google publishes a bounded gallery of structured-data features; Google feature support is narrower than the complete Schema.org vocabulary; Supported markup creates eligibility for a rich result rather than guaranteed appearance. Checked 2026-08-24.Limitation: The gallery is specific to Google Search and changes over time. Absence from it does not prove that every other consumer ignores a Schema.org term.
  11. Google Search Central, “Schema Markup Testing ToolSupports: The Schema Markup Validator checks embedded Schema.org markup without Google feature-specific warnings; The Rich Results Test checks which Google rich results structured data may generate. Checked 2026-08-24.Limitation: Passing either tool does not verify that a claim is true, that deployed markup stays synchronized with visible content, or that a feature will appear.
  12. Google Search Central, “AI features and your websiteSupports: Google applies normal Search eligibility and foundational SEO practices to AI Overviews and AI Mode; Google says there is no special Schema.org markup required for those AI features; Google advises that structured data match visible page text. Checked 2026-08-24.Limitation: This source covers AI features inside Google Search. It does not establish how other AI answer engines consume Schema.org data or promise inclusion or citation.

Continue the evidence path

Run your growth team from one screen.

Invite only