"use strict"; const {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0]; const {useMDXComponents: _provideComponents} = arguments[0]; function _createMdxContent(props) { const _components = { a: "a", code: "code", h2: "h2", h3: "h3", hr: "hr", li: "li", p: "p", pre: "pre", strong: "strong", ul: "ul", ..._provideComponents(), ...props.components }; return _jsxs(_Fragment, { children: [_jsxs(_components.p, { children: [_jsx(_components.a, { href: "/resources/glossary/schema-markup", children: "Schema markup" }), " provides semantic context that AI agents need to understand your content reliably. For AI search, this is not about rich snippets or visual enhancements in search results. It is about structuring data so AI can extract correct information without guessing or hallucinating."] }), "\n", _jsxs(_components.p, { children: ["When an AI agent encounters raw text like \"£99/month\", it must infer this is a price, currency, and recurring cost. With proper schema, you tell it directly: ", _jsx(_components.code, { children: "\"price\": \"99.99\"" }), ", ", _jsx(_components.code, { children: "\"priceCurrency\": \"GBP\"" }), ". The distinction is unambiguous extraction versus probabilistic inference."] }), "\n", _jsx(_components.p, { children: "This guide maps schema types to AI discoverability impact. You will find practical JSON-LD examples ready to deploy, guidance on which types solve real problems versus which are nice-to-have, and validation methods to verify implementation works." }), "\n", _jsx(_components.h2, { children: "Why Schema Matters for AI" }), "\n", _jsxs(_components.p, { children: ["Schema is structured metadata that describes your content to machines. ", _jsx(_components.a, { href: "/resources/glossary/ai-agent", children: "AI agents" }), " use it to understand content structure and context without parsing unstructured text."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "The extraction problem." }), " AI agents must parse unstructured content from millions of pages with different layouts. Schema makes this consistent. A product page with pricing in the header, body text, or sidebar all mean the same thing to a human but require different extraction logic for a machine. Schema standardises this."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Hallucination risk." }), " Without schema, AI might misinterpret data. Consider a page listing \"Free for 30 days, then £99/month.\" An AI might quote \"This product is free\" by cherry-picking the most prominent phrase. Schema clarifies the structure: trial period is temporary, full price applies after. This reduces ", _jsx(_components.a, { href: "/resources/glossary/ai-hallucination", children: "citation errors" }), "."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Extraction at scale." }), " AI agents process information across many sites. Schema allows consistent extraction regardless of layout variations. When every organisation marks up contact information identically, AI doesn't need custom logic for each site."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Citation confidence." }), " When AI cites your content, schema gives it confidence the data is correct. Agents prioritise structured sources when multiple unstructured sources conflict. This is critical for factual queries where accuracy matters."] }), "\n", _jsx(_components.p, { children: "The key insight: schema does not help Google more than it helps AI agents. Google uses schema primarily for rich snippets. AI uses schema for understanding, extraction, and citation confidence across all content types." }), "\n", _jsx(_components.h2, { children: "High-Impact Schema Types" }), "\n", _jsx(_components.p, { children: "These five schema types have the highest impact for most sites. Implement them first." }), "\n", _jsx(_components.h3, { children: "1. Organisation (homepage, all sites)" }), "\n", _jsx(_components.p, { children: "What it does: Identifies your company, logo, contact info, and social profiles." }), "\n", _jsx(_components.p, { children: "JSON-LD:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-json", children: "{\n \"@context\": \"https://schema.org\",\n \"@type\": \"Organization\",\n \"name\": \"Your Company\",\n \"url\": \"https://yoursite.com\",\n \"logo\": \"https://yoursite.com/logo.png\",\n \"contactPoint\": {\n \"@type\": \"ContactPoint\",\n \"contactType\": \"Customer Service\",\n \"telephone\": \"+44-20-XXXX-XXXX\",\n \"email\": \"hello@yoursite.com\"\n },\n \"sameAs\": [\n \"https://twitter.com/yourcompany\",\n \"https://linkedin.com/company/yourcompany\"\n ]\n}\n" }) }), "\n", _jsx(_components.p, { children: "Impact: High. Helps AI understand who you are, how to contact you, and which social profiles represent your brand." }), "\n", _jsxs(_components.p, { children: ["Where: Homepage ", _jsx(_components.code, { children: "" }), ", deployed via template so it loads on every page."] }), "\n", _jsx(_components.h3, { children: "2. Product (e-commerce, SaaS, product pages)" }), "\n", _jsx(_components.p, { children: "What it does: Names product, describes it, lists price, rating, and availability." }), "\n", _jsx(_components.p, { children: "JSON-LD:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-json", children: "{\n \"@context\": \"https://schema.org\",\n \"@type\": \"Product\",\n \"name\": \"Product Name\",\n \"description\": \"Product description\",\n \"image\": \"https://yoursite.com/product.jpg\",\n \"price\": \"99.99\",\n \"priceCurrency\": \"GBP\",\n \"availability\": \"https://schema.org/InStock\",\n \"url\": \"https://yoursite.com/products/product-slug\",\n \"aggregateRating\": {\n \"@type\": \"AggregateRating\",\n \"ratingValue\": \"4.5\",\n \"ratingCount\": \"123\"\n }\n}\n" }) }), "\n", _jsx(_components.p, { children: "Impact: High. AI can extract structured product information including price, availability, and reviews without parsing unstructured text." }), "\n", _jsxs(_components.p, { children: ["Where: Product pages, in ", _jsx(_components.code, { children: "" }), "."] }), "\n", _jsx(_components.h3, { children: "3. Article / BlogPosting (content sites, blogs)" }), "\n", _jsx(_components.p, { children: "What it does: Names article, publication dates, author, and content type." }), "\n", _jsx(_components.p, { children: "JSON-LD:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-json", children: "{\n \"@context\": \"https://schema.org\",\n \"@type\": \"BlogPosting\",\n \"headline\": \"Article Title\",\n \"description\": \"Article summary\",\n \"datePublished\": \"2026-03-22\",\n \"dateModified\": \"2026-03-22\",\n \"author\": {\n \"@type\": \"Person\",\n \"name\": \"Author Name\"\n },\n \"image\": \"https://yoursite.com/article-image.jpg\",\n \"articleBody\": \"Full article text here...\"\n}\n" }) }), "\n", _jsx(_components.p, { children: "Impact: High. Helps AI date articles correctly and attribute authorship when summarising or citing content." }), "\n", _jsxs(_components.p, { children: ["Where: Blog post pages, in ", _jsx(_components.code, { children: "" }), "."] }), "\n", _jsx(_components.h3, { children: "4. BreadcrumbList (all sites with hierarchy)" }), "\n", _jsx(_components.p, { children: "What it does: Shows navigation hierarchy for the current page." }), "\n", _jsx(_components.p, { children: "JSON-LD:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-json", children: "{\n \"@context\": \"https://schema.org\",\n \"@type\": \"BreadcrumbList\",\n \"itemListElement\": [\n {\n \"@type\": \"ListItem\",\n \"position\": 1,\n \"name\": \"Home\",\n \"item\": \"https://yoursite.com\"\n },\n {\n \"@type\": \"ListItem\",\n \"position\": 2,\n \"name\": \"Products\",\n \"item\": \"https://yoursite.com/products\"\n },\n {\n \"@type\": \"ListItem\",\n \"position\": 3,\n \"name\": \"Product Name\",\n \"item\": \"https://yoursite.com/products/product-slug\"\n }\n ]\n}\n" }) }), "\n", _jsx(_components.p, { children: "Impact: Medium-high. Helps AI understand site structure and navigation paths, which aids in contextual relevance when answering queries." }), "\n", _jsxs(_components.p, { children: ["Where: Product/article pages, in ", _jsx(_components.code, { children: "" }), " or body."] }), "\n", _jsx(_components.h3, { children: "5. FAQ / HowTo (support, educational content)" }), "\n", _jsx(_components.p, { children: "What it does: Structures questions, answers, or step-by-step instructions." }), "\n", _jsx(_components.p, { children: "FAQ JSON-LD:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-json", children: "{\n \"@context\": \"https://schema.org\",\n \"@type\": \"FAQPage\",\n \"mainEntity\": [\n {\n \"@type\": \"Question\",\n \"name\": \"What is this product?\",\n \"acceptedAnswer\": {\n \"@type\": \"Answer\",\n \"text\": \"Answer text here\"\n }\n }\n ]\n}\n" }) }), "\n", _jsx(_components.p, { children: "HowTo JSON-LD:" }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-json", children: "{\n \"@context\": \"https://schema.org\",\n \"@type\": \"HowTo\",\n \"name\": \"How to do X\",\n \"step\": [\n {\n \"@type\": \"HowToStep\",\n \"position\": 1,\n \"name\": \"Step 1\",\n \"text\": \"Step 1 description\"\n }\n ]\n}\n" }) }), "\n", _jsx(_components.p, { children: "Impact: Medium. Helps AI extract Q&A content and procedural instructions when users ask how-to questions or seek specific information." }), "\n", _jsxs(_components.p, { children: ["Where: FAQ pages and tutorials, in ", _jsx(_components.code, { children: "" }), "."] }), "\n", _jsx(_components.h2, { children: "Medium-Impact Schema Types" }), "\n", _jsx(_components.p, { children: "These types are worth implementing if you have the relevant content, but are not critical for AI discoverability." }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "LocalBusiness." }), " If you operate physical locations, this schema helps AI find opening hours, address, and phone number. Essential for local search queries."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Event." }), " If you host events, this schema conveys dates, times, locations, and ticket prices. AI can surface events in response to \"when\" or \"where\" queries."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Recipe." }), " For cooking sites, this helps AI extract ingredients, instructions, cooking times, and nutritional information."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "NewsArticle." }), " If you publish news content, this is similar to BlogPosting but signals the content is timely news. Use for breaking news or current affairs."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "JobPosting." }), " If you are hiring, this schema helps AI find job listings with details including title, company, salary, and location."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Priority:" }), " Implement these if your content type matches. Otherwise, focus on the high-impact types first."] }), "\n", _jsx(_components.h2, { children: "Schema You Can Likely Skip" }), "\n", _jsx(_components.p, { children: "Some schema types are nice-to-have but rarely critical for AI discoverability." }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Review/AggregateRating." }), " Useful for Google rich snippets where star ratings appear visually. Less critical for AI agents because they can read review text directly from the page."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Thing/WebPage." }), " Too generic. Prefer specific types like Product, Article, or Event that provide meaningful context."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Markup for rich snippets." }), " Optimised for Google Search display. AI agents do not use these visual enhancements."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Custom properties not in schema.org." }), " Stick to official schema.org types. Custom properties create extraction problems for AI agents that expect standardised structures."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Real talk:" }), " If you are unsure whether a schema type helps AI discovery, it probably does not. Focus your resources on the high-impact types listed above."] }), "\n", _jsx(_components.h2, { children: "Implementation Best Practices" }), "\n", _jsx(_components.p, { children: "Follow these practices to implement schema correctly." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Format: Use JSON-LD (not RDFa or Microdata)" }) }), "\n", _jsx(_components.p, { children: "JSON-LD is the industry standard. It is easiest to implement as pure JSON in a script tag and is most AI-friendly. Avoid legacy formats like RDFa or Microdata unless you have specific compatibility requirements." }), "\n", _jsx(_components.pre, { children: _jsx(_components.code, { className: "language-html", children: "\n \n\n" }) }), "\n", _jsx(_components.p, { children: _jsxs(_components.strong, { children: ["Placement: In ", _jsx(_components.code, { children: "" }), " section"] }) }), "\n", _jsxs(_components.p, { children: ["Most search engines and AI agents expect structured data in the ", _jsx(_components.code, { children: "" }), ". This ensures it loads before the body content and is processed first."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Validation" }) }), "\n", _jsxs(_components.ul, { children: ["\n", _jsxs(_components.li, { children: ["Google Rich Results Test: ", _jsx(_components.a, { href: "https://search.google.com/test/rich-results", children: "https://search.google.com/test/rich-results" })] }), "\n", _jsxs(_components.li, { children: ["Schema.org validator: ", _jsx(_components.a, { href: "https://schema.org/validate/", children: "https://schema.org/validate/" })] }), "\n"] }), "\n", _jsx(_components.p, { children: "Both should pass without errors. Warnings indicate non-critical issues. Errors indicate broken markup that will not parse correctly." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Keep it accurate" }) }), "\n", _jsx(_components.p, { children: "Do not hallucinate properties. Do not add properties that do not match actual page content. Update schema when content changes. Inaccurate schema damages AI trust and reduces citation confidence." }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Tool-based generation (if you have time)" }) }), "\n", _jsxs(_components.p, { children: ["Many frameworks have schema-generation libraries. Next.js offers the ", _jsx(_components.code, { children: "next-seo" }), " package. Generic Node.js libraries include ", _jsx(_components.code, { children: "schema-org" }), ". These reduce manual errors but require maintenance."] }), "\n", _jsx(_components.p, { children: _jsx(_components.strong, { children: "Common mistakes" }) }), "\n", _jsxs(_components.ul, { children: ["\n", _jsx(_components.li, { children: "Using outdated schema type definitions (check schema.org regularly)" }), "\n", _jsx(_components.li, { children: "Nesting properties incorrectly" }), "\n", _jsx(_components.li, { children: "Missing required fields (each type has required properties)" }), "\n", _jsx(_components.li, { children: "Adding schema that does not match actual content" }), "\n"] }), "\n", _jsx(_components.h2, { children: "Testing Your Schema" }), "\n", _jsx(_components.p, { children: "Verification is essential. Implement once, verify it works, monitor over time." }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Automated testing." }), " Use Google Rich Results Test or Schema.org validator to confirm markup parses correctly. These tools catch syntax errors and missing required properties."] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Manual verification." }), " Ask an AI assistant to extract information from your page. If it extracts pricing, dates, or contact details correctly, your schema is working. This tests what actually matters: can AI understand your content?"] }), "\n", _jsxs(_components.p, { children: [_jsx(_components.strong, { children: "Monitoring." }), " Check quarterly that schema has not been accidentally removed during site updates. CMS migrations, template changes, and developer deployments frequently break structured data."] }), "\n", _jsx(_components.p, { children: "Schema implementation is not a one-time task. It is part of ongoing content maintenance. Add schema validation to your release checklist to prevent regressions." }), "\n", _jsx(_components.hr, {}), "\n", _jsxs(_components.p, { children: ["Implemented schema? Run a ", _jsx(_components.a, { href: "/compass", children: "Compass audit" }), " to verify your site is discoverable by AI agents."] })] }); } function MDXContent(props = {}) { const {wrapper: MDXLayout} = { ..._provideComponents(), ...props.components }; return MDXLayout ? _jsx(MDXLayout, { ...props, children: _jsx(_createMdxContent, { ...props }) }) : _createMdxContent(props); } return { default: MDXContent };

Schema Markup for AI Search: High-Impact Types and Implementation