Schema.org markup guide
Schema.org markup is structured data vocabulary that tells search engines and AI systems exactly what your content represents—articles, products, FAQs, authors, and organizations. In 2026, JSON-LD is the standard format, and correct implementation supports rich results, E-E-A-T author signals, and accurate AI citations. This guide covers what to implement, how to validate it, and common mistakes to avoid.
What is Schema.org and why use structured data?
Schema.org is a collaborative vocabulary founded by Google, Microsoft, Yahoo, and Yandex. It provides standardized property names— headline, author, datePublished, and hundreds more—that machines parse without guessing from layout alone. As Wikipedia explains in its SEO article, structured data is one of several on-page signals that help search engines understand page intent.
Google's structured data introduction emphasizes that markup must reflect visible content on the page. Fabricated reviews, fake ratings, or hidden FAQ answers violate guidelines and can trigger manual actions. Our audit reports validate schema presence and flag common errors automatically.
Which format should you use—JSON-LD or Microdata?
Use JSON-LD. Place a <script type="application/ld+json"> block in the page head or body with a valid JSON object. In Next.js App Router, inject schema via a server component or a dedicated layout script tag—exactly as this guide page does with GuideArticle. JSON-LD keeps markup decoupled from HTML, which simplifies updates when you refactor components.
- JSON-LD — Recommended by Google; easiest to maintain in React/Next.js apps.
- Microdata — Inline HTML attributes; harder to refactor and prone to drift from visible content.
- RDFa — Legacy format; rarely used on modern sites.
What schema types should content sites implement in 2026?
Start with types that match your page purpose. The Article type is essential for guides and blog posts. Include headline, description, url, datePublished, dateModified, and an author object linked to a Person schema with name, url, and sameAs properties pointing to verifiable profiles.
- Article — Guides, blog posts, news; include author Person and publisher Organization.
- FAQPage — Question-and-answer pairs that appear visibly on the page; powers FAQ rich results when eligible.
- Organization / Person — Site-wide entity in root layout; reinforces E-E-A-T per Google's E-E-A-T guidance.
- BreadcrumbList — Mirrors visible breadcrumb navigation for clearer SERP display.
- WebSite + SearchAction — Enables sitelinks search box for brand queries on larger sites.
How do you implement FAQ schema correctly?
The FAQPage type wraps an array of Question entities, each with an acceptedAnswer. Every question in the schema must appear verbatim (or near-verbatim) on the page. Do not mark up content that is hidden behind tabs users must click to reveal, unless that content is visible in the DOM on load.
This guide page passes FAQ items to GuideArticle, which renders both visible FAQ sections and matching JSON-LD via buildFaqSchema. That pattern keeps content and schema synchronized—a requirement Google checks during quality reviews in 2026.
How should you validate and monitor structured data?
Before publishing, test every template type with Google's Rich Results Test and Schema.org's validator. After launch, monitor Search Console Enhancements reports for warnings and errors. Common failures include:
- Missing required properties (e.g.,
imageon Article). - Schema content that contradicts visible page text.
- Duplicate conflicting schema blocks on the same URL.
- Invalid date formats (use ISO 8601:
2026-07-08). - AggregateRating without verifiable reviews on the page.
Re-validate after every template change. Structured data regressions often slip in during redesigns when developers remove script tags but keep visible content intact.
What are the most common schema markup mistakes?
Even experienced developers introduce errors that invalidate rich result eligibility. Watch for these patterns during every audit in 2026:
- Markup without visible content — FAQ answers or review text that exists only in JSON-LD, not on the page.
- Stale dates —
dateModifiedleft unchanged after substantive edits, undermining trust signals. - Generic authors — Using Organization name instead of a real Person with a profile URL on authored content.
- Over-marking — Applying Product schema to pages that are informational guides, confusing crawlers about page intent.
How does schema markup support AI visibility?
Generative engines extract facts from HTML and structured metadata. Explicit author, date, and organization data reduces hallucinated attributions when AI systems summarize your content. Pair schema with an llms.txt file (see our AI visibility guide) and solid technical SEO basics for the strongest machine-readable footprint in 2026.
For deeper E-E-A-T implementation, read our E-E-A-T guide and review how we score schema in our methodology. Structured data is not a ranking hack—it is a clarity layer that helps every discovery channel understand who wrote your content, when it was updated, and what it is about.